> ## Documentation Index
> Fetch the complete documentation index at: https://docs.context.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Smithery

> Connect Context.dev from the Smithery registry, authorize with OAuth, and use its MCP tools from a supported client or the Smithery CLI.

Context.dev is available in the Smithery registry as `context/contextdotdev`. The listing connects to Context.dev's hosted MCP server and exposes tools for search, scraping, crawling, extraction, document parsing, brand intelligence, screenshots, monitors, and batches.

<Card title="Open Context.dev on Smithery" icon="arrow-up-right-from-square" href="https://smithery.ai/servers/context/contextdotdev">
  Review the current server endpoint, tools, and input schemas in the Smithery registry.
</Card>

## Prerequisites

* [Node.js 20 or newer](https://nodejs.org/en/download)
* A Context.dev account for browser authorization
* A Smithery account when using managed Smithery connections or CLI tool calls

<Info>
  Context.dev authentication uses OAuth. You do not need to create or paste a Context.dev API key into Smithery or an MCP client.
</Info>

## Install in an MCP client

Use this path when you want Context.dev tools inside Cursor, Claude Code, Codex, VS Code, Windsurf, or another client supported by the Smithery CLI.

<Steps>
  <Step title="Install the Smithery CLI">
    ```bash theme={null}
    npm install -g smithery@latest
    ```
  </Step>

  <Step title="Add Context.dev to your client">
    Run one command for the client you use:

    ```bash theme={null}
    # Cursor
    smithery mcp add context/contextdotdev --client cursor

    # Claude Code
    smithery mcp add context/contextdotdev --client claude-code

    # Codex
    smithery mcp add context/contextdotdev --client codex

    # VS Code
    smithery mcp add context/contextdotdev --client vscode
    ```

    The CLI writes the MCP server into that client's configuration. Run only the command for your client.
  </Step>

  <Step title="Authorize and reload">
    Complete the Context.dev authorization flow when the client opens it, then restart or reload the client so it discovers the new tools.
  </Step>
</Steps>

Verify the installation with a read-only request in the client:

```text theme={null}
Use Context.dev to scrape https://www.context.dev and return only the page title and source URL.
```

## Use Context.dev from the Smithery CLI

Use this path to let Smithery manage the connection and call Context.dev tools directly from a terminal.

<Steps>
  <Step title="Sign in to Smithery">
    ```bash theme={null}
    smithery auth login
    smithery auth whoami
    ```
  </Step>

  <Step title="Create the connection">
    ```bash theme={null}
    smithery mcp add context/contextdotdev --id context
    ```

    Smithery opens the browser authorization flow. If the browser does not open, visit the setup URL printed by the CLI. The stable `context` ID is used by later commands.
  </Step>

  <Step title="List the available tools">
    ```bash theme={null}
    smithery tool list context
    ```
  </Step>

  <Step title="Make a test call">
    ```bash theme={null}
    smithery tool call context web-scrape-markdown \
      '{"url":"https://www.context.dev"}'
    ```
  </Step>
</Steps>

The test call consumes the normal Context.dev credits for the authorized account.

## Common tools

| Need                      | Tool                                                              |
| ------------------------- | ----------------------------------------------------------------- |
| Find current sources      | `web-search`                                                      |
| Read a known page         | `web-scrape-markdown` or `web-scrape-html`                        |
| Collect several pages     | `web-crawl` or `web-scrape-sitemap`                               |
| Return schema-shaped data | `web-extract`                                                     |
| Retrieve company data     | `get-brand` or `brand-retrieve-unified`                           |
| Track website changes     | Monitor tools such as `create-monitor` and `list-monitor-changes` |
| Process a large URL set   | Batch tools such as `submit-batch` and `get-batch-results`        |

<Warning>
  Creating, updating, running, or deleting monitors and batches changes persistent Context.dev account state. Request those operations explicitly and inspect their arguments before running them.
</Warning>

## Data path

Smithery connects through `https://contextdotdev--context.run.tools`, which proxies the hosted Context.dev MCP server. Smithery manages the connection and OAuth tokens; Context.dev executes the tools. Review [Smithery Connect security](https://smithery.ai/docs/use/connect) before sending sensitive data through this path.

## Troubleshooting

| Symptom                                                 | Fix                                                                                                                |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `smithery` is not found                                 | Install Node.js 20 or newer, then rerun `npm install -g smithery@latest`.                                          |
| The connection remains `auth_required`                  | Rerun `smithery mcp add context/contextdotdev --id context` and complete the printed setup URL.                    |
| A client does not show Context.dev tools                | Reload the client, then confirm the install with `smithery mcp list --client <client-name>`.                       |
| `smithery tool list context` cannot find the connection | Run `smithery mcp list`, check the connection ID, and pass that ID instead of `context`.                           |
| Tool calls fail for insufficient credits                | Review usage in the [Context.dev dashboard](https://context.dev/dashboard); repeated retries will not add credits. |

## Reference

<CardGroup cols={2}>
  <Card title="Smithery listing" icon="server" href="https://smithery.ai/servers/context/contextdotdev">
    Live Context.dev tool catalog and schemas on Smithery.
  </Card>

  <Card title="Smithery Connect docs" icon="book" href="https://smithery.ai/docs/use/connect">
    Connection lifecycle, OAuth, credential storage, and direct tool calls.
  </Card>

  <Card title="Smithery CLI source" icon="github" href="https://github.com/smithery-ai/cli">
    Current install, connection, client, and tool commands.
  </Card>

  <Card title="Context.dev MCP guide" icon="robot" href="/install-mcp">
    Hosted MCP capabilities and authentication details.
  </Card>
</CardGroup>