# Web search and page reading for Cursor

> Add Clawifi to Cursor and its agent can search the web, read docs pages and PDFs, and bring back the passages that answer the question, each with its source, while it edits your code.

Canonical page: https://clawifi.dev/for/cursor

- Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=clawifi&config=eyJ1cmwiOiJodHRwczovL2FwaS5jbGF3aWZpLmRldi9tY3AifQ==
- Install in VS Code: vscode:mcp/install?%7B%22name%22%3A%22clawifi%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.clawifi.dev%2Fmcp%22%7D

No key needed to try: 4 tools, 50 calls a day per address. Add your API key for the full toolset.

## What Clawifi gives Cursor

Cursor’s agent edits code with what it knows. With Clawifi it can read the current docs for an API before it writes the call, check a migration guide, or pull the exact passage from a spec into its answer.

- **Search:** `search_free` searches many engines as one and returns ranked results with their sources.
- **Read:** `fetch_url` and `scrape_url` read pages and PDFs as Markdown; with a `query`, `scrape_url` returns only the passages that answer it.
- **Parse and discover:** `extract_url` pulls structured fields from a page; `map_site` lists a site’s URLs; `start_crawl` and `get_crawl` read several pages.
- **Jobs, history and monitors:** `create_job`, `get_job`, `list_history` and `list_monitors` for longer runs and scheduled checks.
- **Cost first:** `estimate` prices a call before it runs, and the account tools show your credits.

## Set it up

### 1. Get an API key

Create an account at [clawifi.dev/signup](https://clawifi.dev/signup). The Free plan includes 1,000 credits a month. Copy the key the console shows you (it is shown once) and keep it in an environment variable, `CLAWIFI_API_KEY`.

### 2. Add the hosted server

Use the Add to Cursor button above, or paste this into `~/.cursor/mcp.json` (or the project’s `.cursor/mcp.json`). Cursor reads CLAWIFI_API_KEY from your environment.

**mcp.json**

```json
{
  "mcpServers": {
    "clawifi": {
      "url": "https://api.clawifi.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:CLAWIFI_API_KEY}"
      }
    }
  }
}
```

### 3. Or run it locally

Install the package, then use this block instead. Cursor starts `clawifi-mcp` itself.

**Terminal**

```sh
pip install clawifi
```

**mcp.json**

```json
{
  "mcpServers": {
    "clawifi": {
      "command": "clawifi-mcp",
      "env": {
        "CLAWIFI_API_KEY": "your_key"
      }
    }
  }
}
```

### 4. Ask the agent

Open the agent and ask something that needs the web, naming Clawifi if you want the agent to use it.

Sources for this setup: [Clients](https://clawifi.dev/docs/clients) · [Remote MCP](https://clawifi.dev/docs/remote-mcp). Clawifi works with Cursor; it is not affiliated with its makers.

## Example prompts

> Use Clawifi to read the Stripe API docs page for PaymentIntents and update `createPayment()` to the current parameters. Cite the passages you used.

> Search the web with Clawifi for the Next.js guide to migrating from the pages router, read it, and list the steps that apply to this project.

> Read this RFC with Clawifi and find the section that defines the retry rules, then check our client against it: https://www.rfc-editor.org/rfc/rfc9110

## Questions

### How do I add Clawifi to Cursor?

Use the Add to Cursor button on this page, or put the hosted server in `~/.cursor/mcp.json` with `"url": "https://api.clawifi.dev/mcp"` and an `Authorization: Bearer` header that reads `CLAWIFI_API_KEY` from your environment.

### Does the Add to Cursor button need a key?

No. It adds the hosted server without one, and 4 tools work as a trial: 50 calls a day per address. Add your key to the header for the full toolset.

### Can I use it in a single project only?

Yes. Put the same block in the project’s `.cursor/mcp.json` instead of the one in your home folder.

### What does it cost?

Most calls cost 1 credit and a browser render 3. Cache hits and failures on Clawifi’s side cost 0; a page whose site answers with an error (such as a 404) is charged as usual. The Free plan includes 1,000 credits a month. See [Pricing](https://clawifi.dev/pricing).

## Other agents and frameworks

- [Clawifi for Codex](https://clawifi.dev/for/codex): Add Clawifi to Codex and it can search the web, read pages and PDFs, and return the passages that answer the question, each with its source.
- [Clawifi for Claude Desktop](https://clawifi.dev/for/claude-desktop): Add Clawifi to Claude Desktop and Claude can search the web, read pages and PDFs, and quote the passages that answer your question, each with its source.
- [Clawifi for Hermes Agent](https://clawifi.dev/for/hermes-agent): Add Clawifi to Hermes Agent and it can search the web, read pages and PDFs, and bring back the passages that answer the question, each with its source.
- [All agent guides](https://clawifi.dev/for): Every client and framework.

Next: [Integrations](https://clawifi.dev/integrations) · [Docs](https://clawifi.dev/docs) · [Pricing](https://clawifi.dev/pricing)