# MCP: Claude, ChatGPT and Cursor

> Connect Pullwire to Claude, ChatGPT, Cursor, Claude Code and n8n. One server, every tool.

The remote server is `https://pullwire.dev/api/mcp` (Streamable HTTP). Its name is `pullwire`. Listing the tools is free and needs no key. Each tool call is charged to your credits, the same as the API.

<Callout title="Before you start">
  [Sign up](/login) with your email. New accounts get 2,000 free credits, no card. Then either
  sign in with OAuth (Claude and ChatGPT) or create a key at [API keys](/app/keys) (it starts
  with `af_live_`) for Claude Code, Cursor and n8n.
</Callout>

## Claude (claude.ai, Desktop, Cowork) [#claude-claudeai-desktop-cowork]

Claude’s connector directory and custom connectors sign in with OAuth. You do not paste an API key.

1. In Claude, open **Customize → Connectors → Add → Custom → Web**.
2. Name it `Pullwire`. Server URL: `https://pullwire.dev/api/mcp`.
3. Authentication: **Sign in when needed** (or Sign in now). OAuth client: **Register automatically**, or **Use Claude’s published identity**.
4. Approve the Pullwire consent screen. That connects the tools to your credit balance.

The same URL works for a directory submission. Tool calls without a session return `401` with the OAuth discovery header, which is what Claude uses to start sign-in. Listing tools stays open, so a directory can read the catalog first.

A fixed `x-api-key` header is a beta option on some Claude Team and Enterprise plans (Request headers when you add the connector). The header name is `x-api-key`. Prefer OAuth when each person should use their own account.

## Claude Code [#claude-code]

Run this once in your terminal. Replace `YOUR_API_KEY` with your key.

```bash title="Terminal"
claude mcp add --transport http pullwire \
  https://pullwire.dev/api/mcp \
  --header "x-api-key: YOUR_API_KEY"
```

Claude Code can also sign in with OAuth (a localhost callback) if you add the server without a header. The API-key header is the path that does not open a browser.

## Claude Desktop (local config) [#claude-desktop-local-config]

Settings → Developer → Edit Config (claude_desktop_config.json). Needs Node.js. The small `mcp-remote` helper connects the desktop app to our server.

```json title="claude_desktop_config.json"
{
  "mcpServers": {
    "pullwire": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pullwire.dev/api/mcp",
        "--header",
        "x-api-key:${PULLWIRE_API_KEY}"
      ],
      "env": {
        "PULLWIRE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

## ChatGPT [#chatgpt]

Custom MCP servers are available on ChatGPT Business and Enterprise. You do not need Developer Mode.

1. Open **Plugins** (or Apps) and choose **Add custom MCP server**.
2. Name: `Pullwire`. URL: `https://pullwire.dev/api/mcp`.
3. Authentication: OAuth. ChatGPT reads `/.well-known/oauth-authorization-server`, sends you to the Pullwire consent screen, and refreshes the token (`offline_access` is advertised).
4. Review the tools and save.

Sign up first if you do not have an account yet. The consent screen uses the same login as the dashboard.

## Cursor [#cursor]

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project). Restart Cursor so it picks up the new server. A `.mcp.json` at the project root is the file cursor.directory reads. Put your key in the `PULLWIRE_API_KEY` environment variable.

```json title="mcp.json"
{
  "mcpServers": {
    "pullwire": {
      "url": "https://pullwire.dev/api/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

## n8n and other HTTP clients [#n8n-and-other-http-clients]

n8n’s HTTP Request node calls the REST API. The [n8n guide](/docs/n8n) has the cURL import. For an MCP client node, use the same server URL and send the header `x-api-key`.

Any other client that speaks Streamable HTTP can do one of two things:

- Send `x-api-key: YOUR_API_KEY` or `Authorization: Bearer YOUR_API_KEY` on every request.
- Follow the OAuth 2.1 discovery on a `401` (`/.well-known/oauth-protected-resource`, then the authorization server). PKCE S256 is required. Public clients can register at `POST /oauth/register`.

## Ask your agent [#ask-your-agent]

Try: “Get the transcript of https://www.youtube.com/watch?v=jNQXAC9IVRw and summarise it.” The agent picks the `youtube-transcripts` tool, and the answer costs 1 credit.

## Good to know [#good-to-know]

- Server URL: `https://pullwire.dev/api/mcp`. Protocol name: `pullwire`.
- Listing the tools is free. Each tool call is charged per result that comes back. Failed results are free.
- Most tools cost 1 credit per result. A page that needs a browser or a residential proxy costs more; the tool’s description says the price.
- Revoke a connected client from **API keys** in the dashboard (the key is named `MCP · …`).
- Logo for directory forms: [512×512 mark](/pullwire-mark-512.png). Legal pages: [Imprint](/imprint), [Privacy](/privacy), [Terms](/terms).