MCintelligentplus MCP Server

The MCintelligentplus MCP server exposes your workspace to any Model Context Protocol client. Your agent gets 18 native, typed tools: every scraper (Reddit, YouTube, Google Maps, Google Search, web crawl), full knowledge-base access (search, read, add, upload, update, delete), and a workspace selector.

Connect it two ways: the hosted server at https://www.magiccreative.io/mcp (nothing to install — just an API key), or run it yourself over stdio against any MCintelligentplus backend, cloud or self-hosted.

Create an API key

You need a MCintelligentplus API key either way. In MCintelligentplus, open User Settings → API Keys:

1. Create a personal API key (ss_pat_…) and copy it — it is shown only once.

Connect (hosted)

The hosted server runs at https://www.magiccreative.io/mcp. Point your client at it and send the key as a Bearer token — there is nothing to install and no backend to run. For clients that read an mcpServers map (Cursor, and others):

{
  "mcpServers": {
    "surfsense": {
      "url": "https://www.magiccreative.io/mcp",
      "headers": { "Authorization": "Bearer ss_pat_your_key_here" }
    }
  }
}

Claude Code, from a terminal:

claude mcp add --transport http surfsense https://www.magiccreative.io/mcp \
  --header "Authorization: Bearer ss_pat_your_key_here"

Most MCP clients accept this url + headers form; check your client's docs for its exact remote-server field.

Self-host (stdio)

Run the server yourself when you host your own backend or use a client without remote support. It runs with uv — install it once, then from the MCintelligentplus repository run:

cd surfsense_mcp
uv sync

Point the server at your backend with SURFSENSE_BASE_URL:

• MCintelligentplus Cloud: https://www.magiccreative.io
• Self-hosted: wherever your backend runs, e.g. http://localhost:8000

Every client below launches the same command — uv run --directory <path-to>/surfsense_mcp python -m mcp_server — and passes SURFSENSE_BASE_URL and SURFSENSE_API_KEY as environment variables. Replace the placeholder paths and key with yours.

claude mcp add surfsense \
  -e SURFSENSE_BASE_URL=https://www.magiccreative.io \
  -e SURFSENSE_API_KEY=ss_pat_your_key_here \
  -- uv run --directory /path/to/SurfWise/surfsense_mcp python -m mcp_server

[mcp_servers.surfsense]
command = "uv"
args = ["run", "--directory", "/path/to/SurfWise/surfsense_mcp", "python", "-m", "mcp_server"]

[mcp_servers.surfsense.env]
SURFSENSE_BASE_URL = "https://www.magiccreative.io"
SURFSENSE_API_KEY = "ss_pat_your_key_here"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "surfsense": {
      "type": "local",
      "command": ["uv", "run", "--directory", "/path/to/SurfWise/surfsense_mcp", "python", "-m", "mcp_server"],
      "enabled": true,
      "environment": {
        "SURFSENSE_BASE_URL": "https://www.magiccreative.io",
        "SURFSENSE_API_KEY": "ss_pat_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "surfsense": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/SurfWise/surfsense_mcp", "python", "-m", "mcp_server"],
      "env": {
        "SURFSENSE_BASE_URL": "https://www.magiccreative.io",
        "SURFSENSE_API_KEY": "ss_pat_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "surfsense": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/SurfWise/surfsense_mcp", "python", "-m", "mcp_server"],
      "env": {
        "SURFSENSE_BASE_URL": "https://www.magiccreative.io",
        "SURFSENSE_API_KEY": "ss_pat_your_key_here"
      }
    }
  }
}

{
  "servers": {
    "surfsense": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/SurfWise/surfsense_mcp", "python", "-m", "mcp_server"],
      "env": {
        "SURFSENSE_BASE_URL": "https://www.magiccreative.io",
        "SURFSENSE_API_KEY": "ss_pat_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "surfsense": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/SurfWise/surfsense_mcp", "python", "-m", "mcp_server"],
      "env": {
        "SURFSENSE_BASE_URL": "https://www.magiccreative.io",
        "SURFSENSE_API_KEY": "ss_pat_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "surfsense": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/SurfWise/surfsense_mcp", "python", "-m", "mcp_server"],
      "env": {
        "SURFSENSE_BASE_URL": "https://www.magiccreative.io",
        "SURFSENSE_API_KEY": "ss_pat_your_key_here"
      }
    }
  }
}

Test it

In a fresh agent session, try:

list my MCintelligentplus workspaces

That calls surfsense_list_workspaces — the simplest end-to-end check of the key, backend, and server. Then try a real task:

find the top subreddits discussing NotebookLM and save a summary note to my workspace

Configuration reference

For self-host (stdio), all settings are environment variables passed by the client. The hosted server needs only your API key in the Authorization header:

Troubleshooting

• 401 errors — the API key is wrong or expired; create a new one.
• 403 errors — the workspace is outside the key's organisation, or the key's API client was disabled. Check the client under Admin → API Clients (or Org → Settings → API clients).
• "Could not reach MCintelligentplus" — the backend isn't running or SURFSENSE_BASE_URL is wrong.
• Server won't start — run uv run python -m mcp_server.selfcheck inside surfsense_mcp; it verifies all 18 tools register without needing a backend.

Tools reference

Usage is billed exactly like the REST API — scraper tools are metered per returned item, and every call is recorded under API Playground → Runs.