#CLICopy page

The CLI is the most flexible way to use curl.md. It works well with agents or in terminals, editors, scripts, and anywhere else you can shell out.

#Quick Start

Install the CLI, optionally authenticate, and fetch your first page.

1. 1

   Install CLI

   Install the CLI via curl, npm, or bun.

   curlnpmbun

   $curl -fsSL https://curl.md/install.sh | bash

2. 2

   Authenticate

   Optionally log in to unlock higher usage limits and features, like objective extraction.

   $curl.md auth login

3. 3

   Use CLI

   Fetch a page from your terminal:

   $curl.md curl.md/docs/guide/cli

#Install

Install the CLI using your favorite method.

$npm i -g curl.md

Or with Bun:

$bun i -g curl.md

If you prefer a script-based install:

$curl -fsSL https://curl.md/install.sh | bash

Verify it works:

$curl.md --version

You can also install by downloading releases on the GitHub Releases page.

#Usage

Fetch a page:

$md example.com

Narrow by objective with --objective:

$md zod.dev/error-formatting --objective tree error formatting

Add keywords with --keywords:

md developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch \
  --objective streaming response body \
  --keywords ReadableStream,getReader

Choose a mode with --mode:

md developers.cloudflare.com/d1/get-started \
  --objective how to query D1 from a worker \
  --keywords D1,bindings \
  --mode rush

Bypass cache with --fresh:

$md example.com --fresh

Finally, learn more about the CLI with --help:

$md --help

#Authentication

Log in from the CLI to unlock higher usage limits and features, like objective extraction.

$curl.md auth login

For non-interactive environments, set CURLMD_API_KEY.

#Agents

If your agent can shell out locally and does not already have a first-party integration, sync the curl.md CLI skills into it:

$curl.md skills add

These generated skills teach the agent how to use the curl.md CLI effectively inside your terminal workflow.

If you want to install the skills into the current project instead of your global agent config, use:

$curl.md skills add --no-global

It’s recommended to use native agent plugins instead of direct CLI usage when possible.

#MCP

If your editor or agent supports MCP stdio servers, you can run the CLI directly in MCP mode:

$curl.md --mcp

That exposes curl.md’s fetch command as an MCP tool, so hosts without a first-party curl.md integration can still fetch URLs through the normal CLI/API path.

If your agent supports automatic MCP registration, you can also use:

$curl.md mcp add

See mcp add below for supported options and agent targeting.

#Commands

#curl.md <url>

URL to markdown for agents

$curl.md example.com$curl.md docs.github.com/en/webhooks/webhook-events-and-payloads --objective pull request webhook event payload and actions --keywords pull_request$curl.md developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch --objective streaming response body --keywords ReadableStream,getReader$curl.md developers.cloudflare.com/d1/get-started --objective how to query D1 from a worker --keywords D1,bindings$curl.md ai-sdk.dev/docs/ai-sdk-core/generating-text --objective how to stream text with the ai sdk --keywords streamText,generateText$curl.md zod.dev/error-formatting --objective tree error formatting --keywords treeifyError

#auth

Authenticate with curl.md (login, logout, status)

#login

Log in with curl.md

$curl.md auth login

#logout

Log out of the curl.md CLI

$curl.md auth logout

#status

Check authentication status

$curl.md auth status [options]

#credits

Manage prepaid credits (add, status)

#add

Add credits

$curl.md credits add <5|10|20|50>

#status

Check credits

$curl.md credits status

#fetch

Fetch URL as markdown

$curl.md fetch <url> [options]

$curl.md fetch example.com$curl.md fetch docs.github.com/en/webhooks/webhook-events-and-payloads --objective pull request webhook event payload and actions --keywords pull_request$curl.md fetch developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch --objective streaming response body --keywords ReadableStream,getReader$curl.md fetch developers.cloudflare.com/d1/get-started --objective how to query D1 from a worker --keywords D1,bindings$curl.md fetch ai-sdk.dev/docs/ai-sdk-core/generating-text --objective how to stream text with the ai sdk --keywords streamText,generateText$curl.md fetch zod.dev/error-formatting --objective tree error formatting --keywords treeifyError

#org

Manage organizations (create, invite, list, member, switch, view)

#create

Create organization

$curl.md org create <login> [options]

#invite

Manage organization invites (accept, create, list, revoke)

#accept

Accept organization invite

$curl.md org invite accept <token>

#create

Create organization invite link

$curl.md org invite create [options]

#list

List organization invites

$curl.md org invite list

#revoke

Revoke organization invite

$curl.md org invite revoke [invite] [options]

#list

List organizations

$curl.md org list

#member

Manage organization members (add, list, remove, role)

#add

Add member to active organization

$curl.md org member add <login> [options]

#list

List members of the active organization

$curl.md org member list

#remove

Remove member from active organization

$curl.md org member remove [login] [options]

#role

Change member role

$curl.md org member role [login] [options]

#switch

Switch organization

$curl.md org switch [login]

#view

View active organization

$curl.md org view [options]

#request

Manage requests (list, view)

#list

List requests

$curl.md request list [options]

#view

View request

$curl.md request view [request] [options]

#token

Manage API tokens (create, list, delete)

#create

Create API token

$curl.md token create <name>

#delete

Delete API token

$curl.md token delete [name] [options]

#list

List API tokens

$curl.md token list

#update

Update curl.md CLI

$curl.md update [options]

#Integrations

#completions

Generate shell completion script

$curl.md completions <bash|fish|nushell|zsh>

#mcp add

Register as MCP server

$curl.md mcp add [options]

#skills

Sync skill files to agents (add, list)

#add

Sync skill files to agents

$curl.md skills add [options]

#list

List skills

$curl.md skills list

#Environment Variables

#When to use the CLI

Use the CLI when you want your agent to be able to use curl.md, but there isn’t a plugin, or in shell scripts, editor terminals, local automation, or quick one-off research.