Model Context Protocol

MCP Server

Plug NeuroAPI directly into any MCP-compatible AI agent — Claude Desktop, Cursor, Continue, ChatGPT desktop, or your own — and let the agent scrape, search, map, and crawl the web on demand.

Endpoint

Streamable HTTP transport. Your API key goes in the URL path — no Authorization header needed. This makes it work with every MCP client, including those that don't support custom headers.

POST https://neuroapi.me/api/nk_live_YOUR_KEY/mcp

Accept: application/json, text/event-stream · Transport: Streamable HTTP (stateless)

Available tools

All tools are namespaced with the neuroapi_ prefix to avoid collisions with other MCP servers your agent has connected (e.g. neuroapi_scrape vs another server's scrape).

neuroapi_scrape

Fetch a single URL as clean Markdown. 1 credit.

neuroapi_search

Web search with optional result scraping. ~2 credits.

neuroapi_map

Discover every URL on a website. 1 credit.

neuroapi_crawl

Start a multi-page crawl job. Reserves credits up-front.

neuroapi_crawl_status

Poll a crawl job until done. Free.

neuroapi_crawl_cancel

Cancel a running crawl; refunds unused credits.

neuroapi_extract

LLM-powered structured JSON from a URL. 2 credits.

neuroapi_screenshot

Capture a PNG of a URL. 1 credit.

neuroapi_summary

AI summary of a page in one call. 1 credit.

neuroapi_question

Ask a natural-language question about a page. 5 credits.

neuroapi_highlights

Extract relevant source text from a page matching a query. 5 credits.

neuroapi_batch_scrape

Scrape many URLs in one job. 1 credit per URL.

neuroapi_batch_status

Poll a batch scrape job. Free.

neuroapi_interact

Click / type / scroll on a prior scraped page (uses sessionId). 2 credits.

neuroapi_stop_interaction

Release an interact session early. Free.

neuroapi_parse

Parse a PDF/DOCX/XLSX/HTML (≤50 MB) into markdown — pass a `url` or `fileBase64`. 1 + 1/page.

neuroapi_balance

Return current credits balance. Free.

Interacting with a scraped page

Call neuroapi_scrape first and keep the returned sessionId. Then call neuroapi_interact with either a prompt or code. If your agent sends both, blank code is ignored and prompt wins. Timeouts are accepted in milliseconds.

json

{
  "sessionId": "UPSTREAM_KEY_ID.SCRAPE_ID",
  "prompt": "Click the Browse Gallery link, wait for navigation, then return the updated page content.",
  "timeout": 30000
}

If the session has expired, call neuroapi_scrape again to get a fresh sessionId.

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config) and restart Claude.

json

{
  "mcpServers": {
    "neuroapi": {
      "url": "https://neuroapi.me/api/nk_live_YOUR_KEY/mcp",
      "transport": "http"
    }
  }
}

Cursor / Continue

Add to your MCP config (Cursor → Settings → MCP, or ~/.continue/config.json).

json

{
  "mcpServers": {
    "neuroapi": {
      "url": "https://neuroapi.me/api/nk_live_YOUR_KEY/mcp"
    }
  }
}

Raw JSON-RPC

Talk to the server directly to debug or integrate with custom agents.

bash

curl -X POST https://neuroapi.me/api/nk_live_YOUR_KEY/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Need a key? Create one in your dashboard — every account starts with 100 free credits.