Give your agents SurfSense as native tools
The SurfSense MCP server hands Claude, Cursor, or any MCP client the whole platform: scrape Reddit, YouTube, Google Maps, Google Search, and the open web, and search, read, and write your knowledge base. One API key, typed tools, pay as you go.
.cursor/mcp.json
{
"mcpServers": {
"surfsense": {
"url": "https://mcp.surfsense.com/mcp",
"headers": {
"Authorization": "Bearer ss_pat_..."
}
}
}
}Works with Claude Code, Cursor, Claude Desktop, and any MCP client
From API key to agent tools in three steps
Create an API key
In SurfSense, go to Settings, then API, and create a key. Enable API access on the workspaces you want your agents to reach. That key is all the server needs.
Add the server to your client
Point your client at https://mcp.surfsense.com/mcp with your key in an Authorization header — the hosted config for Cursor, Claude Code, and others is one paste. Prefer stdio? Switch to Self-host and run it against your own backend.
Your agent has the tools
Every scraper and knowledge base operation shows up as a native, typed MCP tool. Your agent picks a workspace once and the server carries the context between calls.
Step-by-step setup for every agent
Pick your client, choose Hosted or Self-host, and paste the config. Replace the key with one from API Playground → API Keys — or grab a pre-filled config from the playground itself.
- Run this command in a terminal (any directory).
- Start Claude Code and run /mcp — surfsense should be listed as connected.
Terminal
claude mcp add --transport http surfsense https://mcp.surfsense.com/mcp \
--header "Authorization: Bearer ss_pat_your_key_here"Every tool the server exposes
The server is a thin layer over the SurfSense REST API: the same endpoints, the same billing, no backend code imported. Whatever ships in the API shows up here.
Live scrapers
Structured, current platform data. One returned item is one billable unit.
- surfsense_reddit_scrape
- surfsense_youtube_scrape
- surfsense_youtube_comments
- surfsense_google_maps_scrape
- surfsense_google_maps_reviews
- surfsense_google_search
- surfsense_web_crawl
- surfsense_list_scraper_runs
- surfsense_get_scraper_run
Knowledge base
Read and write the same knowledge base your SurfSense agents use.
- surfsense_search_knowledge_base
- surfsense_list_documents
- surfsense_get_document
- surfsense_add_document
- surfsense_upload_file
- surfsense_update_document
- surfsense_delete_document
Workspace selector
Pick a workspace once; every later call defaults to it.
- surfsense_list_workspaces
- surfsense_select_workspace
The SurfSense MCP server vs external MCP connectors
They are two sides of the same protocol. The MCP server on this page pushes SurfSense tools out to agents you already run in Claude, Cursor, or your own harness. External MCP connectors do the reverse: they pull outside tools like Notion, Slack, and Jira into your SurfSense agents. Use both and data flows in either direction.
SurfSense MCP server: frequently asked questions
Put live market data inside your agents
The MCP server is part of the SurfSense competitive intelligence platform. Start with $5 of free credit, no credit card required.
SurfSenseSurfSense