rapid-indexer-mcp

Model Context Protocol server for Rapid Indexer. It lets Claude, Cursor, ChatGPT, Claude Code and any other MCP host submit URLs to Googlebot, check whether pages are indexed, read task results and launch traffic / CTR campaigns using your Rapid Indexer API key.

Built on the official TypeScript SDK v2 (@modelcontextprotocol/server). Serves over stdio (local, one account) or Streamable HTTP (hosted, multi-tenant: each request carries its own API key).

Requirements

• Node.js 20+
• A Rapid Indexer API key: log in, open your account menu → API Access (https://rapid-indexer.com/api_access).

Quick start (stdio)

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "rapid-indexer": {
      "command": "npx",
      "args": ["-y", "rapid-indexer-mcp"],
      "env": { "RAPID_INDEXER_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop

~/.config/Claude/claude_desktop_config.json on Linux:

{
  "mcpServers": {
    "rapid-indexer": {
      "command": "npx",
      "args": ["-y", "rapid-indexer-mcp"],
      "env": { "RAPID_INDEXER_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Code

claude mcp add rapid-indexer -e RAPID_INDEXER_API_KEY=YOUR_API_KEY -- npx -y rapid-indexer-mcp

From a local checkout (before publishing to npm)

cd mcp
npm install
npm run build

Then point the host at the built CLI:

{
  "mcpServers": {
    "rapid-indexer": {
      "command": "node",
      "args": ["/absolute/path/to/Rapid-Indexer-main/mcp/dist/cli.js"],
      "env": { "RAPID_INDEXER_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Hosted mode (Streamable HTTP)

One process serves every customer; the API key travels with each request.

RAPID_INDEXER_BASE_URL=https://rapid-indexer.com \
node dist/cli.js --http --host 0.0.0.0 --port 3333 --path /mcp

Clients connect to https://your-host/mcp and send Authorization: Bearer <api key> (also accepted: X-API-Key: <key>, or ?api_key= on the URL). GET /healthz returns a liveness JSON.

Cursor example for a remote server:

{
  "mcpServers": {
    "rapid-indexer": {
      "url": "https://mcp.rapid-indexer.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Put it behind TLS (nginx/Caddy) and run it with systemd or pm2. The server is stateless, so you can run several replicas. --api-key / RAPID_INDEXER_API_KEY in HTTP mode is only a fallback for requests that carry no key (single-tenant self-hosting).

Tools

| Tool | Spends credits | What it does | |------|:--:|------| | get_account | no | Account id, email, credit balance (+ USD). | | get_pricing | no | Live credits per URL (standard / VIP / checker), traffic price per 1,000 visitors, USD per credit. | | estimate_cost | no | Cost of N URLs as indexer/checker (+VIP) and whether the balance covers it. | | submit_urls_for_indexing | yes | Create an indexing task (standard or VIP queue, optional drip feed). Max 10,000 URLs. | | check_index_status | yes (~0.1 cr/URL) | Create an index-check task: per-URL indexed / unindexed. | | list_tasks | no | Paginated task list with indexed/unindexed/pending/error counts; filter by type/status. | | get_task | no | Refresh and return one task's status and progress. | | get_task_links | no | Per-URL results with status filter and pagination. | | create_traffic_campaign | yes | AI visitors to a URL (geo, device, referrer, behaviour). | | create_ctr_campaign | yes | Visitors search keywords on Google/Bing/… and click your result. | | list_search_engines | no | Valid search_engine values for CTR campaigns. | | check_service_health | no | API version, enabled features, and confirms the key works. |

Every tool returns human-readable text plus structuredContent validated by an output schema. Errors from the API come back as isError results with the API message and a hint (top-up link on insufficient credits, key location on 401).

Prompt: index_and_verify — guided estimate → submit → verify workflow.

Environment / flags

| Variable | Flag | Default | Notes | |----------|------|---------|-------| | RAPID_INDEXER_API_KEY | --api-key | – | Required for stdio. Fallback only in HTTP mode. | | RAPID_INDEXER_BASE_URL | --base-url | https://rapid-indexer.com/api/v1/index.php | Site origin is also accepted; the router path is appended. | | HOST | --host | 127.0.0.1 | HTTP mode. | | PORT | --port | 3333 | HTTP mode. | | MCP_PATH | --path | /mcp | HTTP mode. |

Development

npm install
npm run build          # tsc → dist/
npm run dev            # run src/cli.ts with tsx (stdio)
npm run inspect        # MCP Inspector against dist/cli.js

If npm install hangs on a machine with broken IPv6, run it with NODE_OPTIONS="--no-network-family-autoselection --dns-result-order=ipv4first".

Publishing

npm version patch
npm publish --access public

prepublishOnly builds dist/. The package ships only dist/, README.md and LICENSE.

API coverage

The server talks to the public REST API documented at https://rapid-indexer.com/api-docs. list_tasks and pricing were added to that API together with this server; hosts running an older build of the site will see those two tools fail with "Invalid action" until the API is redeployed.

License

MIT