<p align="center"> <a href="https://www.monocrawl.com"><img src="https://www.monocrawl.com/opengraph-image.png" alt="Monocrawl: one API for social data. Public data for your apps and AI agents." width="720"></a> </p>

Monocrawl MCP

Give your AI agent live public data from 70+ platforms. Profiles, posts, comments, transcripts, products, prices, reviews, listings, jobs, ads and search results from TikTok, Instagram, YouTube, LinkedIn, X, Reddit, Amazon, Walmart, Vinted, Booking.com, Airbnb, Tripadvisor, Zillow, Zoopla, Rightmove, Trustpilot, Google and many more, plus website crawls and live browser sessions. One key, one response format, and 1,000 free credits every month.

Quick start · Client setup · What you can ask · Tools · Platforms · Pricing · Configuration

Why Monocrawl

• 650+ endpoints across REST and MCP. Your agent can call every one of the 610 live data endpoints across 74 platforms straight from this server, including website crawls and live browser sessions.
• Sign in with your browser. One command connects Claude Code, Codex, Cursor, VS Code and five other agents. No key to copy or paste.
• Works in Claude.ai and ChatGPT today. Add Monocrawl as a custom connector and sign in with OAuth.
• Always current. Tools, parameters and prices load live from the hosted service. Nothing is bundled, so nothing goes out of date.
• Spending you control. Every result reports its cost. Cap any call with max_credits, preview any cost for free, and set a credit limit on each connection.
• Failed calls cost nothing. Errors and upstream failures are refunded automatically.
• Big results, paid for once. Large responses are kept for 24 hours, and get_result reads them in full at no charge.

Quick start

1. Browser sign-in (recommended)

npx -y monocrawl-cli@latest init --agent claude

Swap claude for codex, cursor, vscode, grok, opencode, gemini, openclaw or hermes. A browser tab opens, you approve the connection, and the helper writes it to your agent's MCP settings. Your key never appears in the terminal or the chat. Each connection can be given a credit limit or revoked in the dashboard.

2. Hosted server, nothing to install

| Client | How to connect | |---|---| | Claude.ai, ChatGPT | Add a custom connector with https://www.monocrawl.com/mcp/oauth, then sign in | | Claude Code | claude mcp add --scope user --transport http monocrawl https://www.monocrawl.com/mcp --header "Authorization: Bearer mn_your_key_here" | | Gemini CLI | gemini mcp add --scope user --transport http monocrawl https://www.monocrawl.com/mcp/oauth | | Any HTTP client | https://www.monocrawl.com/mcp with an Authorization: Bearer mn_your_key_here or x-api-key header |

3. This package, running locally

For clients that only start local (stdio) servers. Requires Node.js 22 or newer.

{
  "mcpServers": {
    "monocrawl": {
      "command": "npx",
      "args": ["-y", "monocrawl-mcp@latest"],
      "env": {
        "MONOCRAWL_API_KEY": "mn_y…[redacted]"
      }
    }
  }
}

Create a free account and copy a key from API keys. Keys start with mn_. Want to look around first? Leave out the env block: list_endpoints, get_endpoint and get_docs work without an account.

4. Agent skill

Teach Claude Code, Cursor, Codex and other agents how to use Monocrawl: finding the right endpoint, checking its price first and retrying safely.

npx skills add monocrawl/monocrawl-mcp

The skill does not connect Monocrawl on its own. Use one of the options above for the connection.

Client setup

Restart your client after saving its configuration, then ask your agent to check your Monocrawl balance to confirm the tools loaded.

<details> <summary><b>Claude Code</b></summary>

claude mcp add --scope user --transport stdio monocrawl --env MONOCRAWL_API_KEY=mn_y…[redacted] -- npx -y monocrawl-mcp@latest

</details> <details> <summary><b>Claude Desktop</b></summary>

Add this to claude_desktop_config.json: ~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows.

{
  "mcpServers": {
    "monocrawl": {
      "command": "npx",
      "args": ["-y", "monocrawl-mcp@latest"],
      "env": { "MONOCRAWL_API_KEY": "mn_y…[redacted]" }
    }
  }
}

</details> <details> <summary><b>Cursor</b></summary>

Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project.

{
  "mcpServers": {
    "monocrawl": {
      "command": "npx",
      "args": ["-y", "monocrawl-mcp@latest"],
      "env": { "MONOCRAWL_API_KEY": "mn_y…[redacted]" }
    }
  }
}

</details> <details> <summary><b>VS Code</b></summary>

Add this to .vscode/mcp.json. VS Code asks for the key once and stores it securely, so it never sits in the file.

{
  "inputs": [
    { "type": "promptString", "id": "monocrawl-key", "description": "Monocrawl API key", "password": true }
  ],
  "servers": {
    "monocrawl": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "monocrawl-mcp@latest"],
      "env": { "MONOCRAWL_API_KEY": "${input:monocrawl-key}" }
    }
  }
}

</details> <details> <summary><b>Windsurf</b></summary>

Add this to ~/.codeium/windsurf/mcp_config.json.

{
  "mcpServers": {
    "monocrawl": {
      "command": "npx",
      "args": ["-y", "monocrawl-mcp@latest"],
      "env": { "MONOCRAWL_API_KEY": "mn_y…[redacted]" }
    }
  }
}

</details> <details> <summary><b>Codex</b></summary>

Add this to ~/.codex/config.toml.

[mcp_servers.monocrawl]
command = "npx"
args = ["-y", "monocrawl-mcp@latest"]
env = { MONOCRAWL_API_KEY = "mn_y…[redacted]" }

</details> <details> <summary><b>Any other MCP client</b></summary>

Run npx -y monocrawl-mcp@latest as a stdio server with MONOCRAWL_API_KEY in its environment.

</details>

What you can ask

Ask in plain language. Your agent picks the endpoints, checks prices and makes the calls.

| Ask your agent | What it uses | |---|---| | "Get NASA's TikTok profile and its latest videos." | tiktok/profile, tiktok/profile-videos | | "What are people saying about the Stanley cup on Reddit this week?" | reddit/search, reddit/post/comments | | "Compare prices for Sony WH-1000XM5 headphones on Amazon, Walmart and eBay." | amazon/search, walmart/search, ebay/search | | "Summarise the latest Trustpilot reviews for Monzo." | trustpilot/reviews | | "Find hotels in Lisbon on Booking.com for 10 to 14 October." | booking/search-hotels | | "Transcribe this YouTube video and list its sponsors." | youtube/post-transcript, youtube/video-sponsors | | "What have Barbour wax jackets actually sold for on Vinted?" | vinted/sold-comparables | | "Crawl the Vercel changelog and list this month's releases." | start_data_job (web/crawl) | | "What would a Zoopla valuation cost before I run it?" | get_endpoint (free) | | "Watch r/MechanicalKeyboards for posts about Keychron and show me new ones each morning." | create_monitor, monitor_findings |

Every response uses the same envelope on every platform. This is a real response for NASA's TikTok profile, recorded on 26 September 2026 and trimmed:

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/profile",
  "data": {
    "handle": "nasa",
    "name": "NASA",
    "url": "https://www.tiktok.com/@nasa",
    "verified": true,
    "followers": 1829985,
    "following": 23,
    "likes_count": 9619119,
    "video_count": 48
  },
  "credits_used": 1
}

Full responses also carry credits_remaining and a request_id for support and receipts.

Tools

19 tools. The ones that start jobs, open browsers or change monitors show a free preview first and only act once confirmed.

| Tool | What it does | Account needed | Cost | |---|---|---|---| | list_endpoints | Browse the live catalogue by platform or keyword, with each endpoint's price | No | Free | | get_endpoint | One endpoint in full: parameters, price and a ready-to-run example | No | Free | | get_docs | Read Monocrawl guides as Markdown | No | Free | | call_endpoint | Fetch live data from any endpoint. max_credits caps the charge, idempotency_key makes retries safe, dry_run returns a free estimate | Yes | The endpoint's price | | get_result | Read a large result in full for 24 hours without running it again | Yes | Free | | get_balance | Your credits and this connection's spending limit | Yes | Free | | list_monitors | Every monitor with its schedule, last run and spend this month | Yes | Free | | get_monitor | One monitor with its recent runs and receipts | Yes | Free | | create_monitor | Watch a subject across platforms on a schedule. Shows the plan and estimate first, then creates it once confirmed | Yes | 1 credit, then each run | | update_monitor | Pause, resume, rename or reschedule a monitor | Yes | Free | | run_monitor | Run a monitor now. Shows the estimate first | Yes | Per run | | monitor_findings | New findings with evidence links, newest first | Yes | Free | | mark_monitor_findings_seen | Mark findings as read | Yes | Free | | delete_monitor | Delete a monitor once confirmed | Yes | Free | | start_data_job | Crawl a website, batch-scrape many URLs, run an autonomous web task, or collect Tripadvisor attraction and restaurant reviews. Gives a free estimate first, then starts with a credit cap | Yes | The job's price | | cancel_web_job | Check on a data job or cancel it | Yes | Free | | create_browser_session | Open a hosted browser, optionally on a web page. Gives a free estimate first, then opens with a credit cap | Yes | The session's price | | execute_browser_session | Run code in the live page to click, type, fill in forms or read it. Shows the exact code and page before anything runs | Yes | Per run | | close_browser_session | Close a browser session | Yes | Free |

Monitors keep running on Monocrawl's servers after your chat closes, and deliver findings to the dashboard or your own destinations.

Platforms

All 610 live data endpoints across 74 platforms are callable from this server, through the same key as the REST API. Ask your agent to run list_endpoints for the live list with prices.

Social and community

| Platform | Endpoints | What your agent can get | |---|---:|---| | TikTok | 35 | Profiles, videos, comments and replies, transcripts, trending, TikTok's popular hashtag and video boards, top ads, search across videos, users, hashtags and sounds, hashtag details, songs and effects, followers and following, audience, liked videos, reposts, playlists, collections, places, live status | | Instagram | 38 | Profiles and account details, posts, reels, full post and reel feeds, stories and highlights, comments and replies, likers, engagement and post stats, followers and following, similar accounts, username suggestions, tagged, location and audio feeds, transcripts, trending reels