pullwireDocs

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.

Before you start

Sign up 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 (it starts with af_live_) for Claude Code, Cursor and n8n.

Claude (claude.ai, 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

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

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)

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

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

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

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.

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

n8n and other HTTP clients

n8n’s HTTP Request node calls the REST API. The n8n guide 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

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

  • 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. Legal pages: Imprint, Privacy, Terms.

On this page