Setup guide · MCP

Set up seenpaid in Windsurf

Windsurf is the AI code editor whose agent is Cascade. Cascade can call any MCP server in its config. Add seenpaid and it can schedule the post about the feature it just helped you ship, without you leaving the editor.

Start your 7-day trial →Jump to the setup

Card required, no charge until day 8. MCP access is on every plan.

$
Endpoint
api.seenpaid.com/mcp
Transport
Streamable HTTP
Auth
Bearer sp_…
Tools
50

Four steps

How to connect Windsurf to seenpaid

You need a seenpaid API key and one paste.

  1. 1

    Create an API key

    In seenpaid, open Settings → API keys and create a key. It starts with sp_ and is shown once, so copy it straight into the next step. You can revoke it at any time.

    Open Settings → API keys
  2. 2

    Add seenpaid to Windsurf

    Open the MCPs icon at the top of the Cascade panel (or Settings → Cascade → MCP Servers) and edit the raw mcp_config.json. Paste this entry. The docs also accept "url", but "serverUrl" is the key their remote example uses.

    ~/.codeium/windsurf/mcp_config.json
    {
  "mcpServers": {
    "seenpaid": {
      "serverUrl": "https://api.seenpaid.com/mcp",
      "headers": { "Authorization": "Bearer sp_your_api_key" }
    }
  }
}

    Replace sp_your_api_key with your key.

    Checked against the official docs: docs.windsurf.com/windsurf/cascade/mcp (now docs.devin.ai/desktop/cascade/mcp) — remote servers take "serverUrl" and "headers" in ~/.codeium/windsurf/mcp_config.json.

  3. 3

    Restart and verify

    Open the MCPs panel in Cascade. seenpaid should appear with its tools, which you can switch on or off one by one.

  4. 4

    Ask for your first post

    Start with “Which of my social accounts are connected?” — Windsurf calls list_accounts and names your channels. If none are connected yet, ask for a connect link: that one step needs you in a browser.

Try asking

First things to ask Windsurf

Plain requests. Under each one, the seenpaid tools Windsurf calls to answer it.

  • Which of my social accounts are connected?

    Callslist_accounts

  • Schedule a post about this release to LinkedIn for tomorrow morning.

    Callsschedule_post

  • Is anything failing to publish right now?

    Callslist_postsget_account_health

  • Rank my channels by revenue per post.

    Callsget_channel_roi needs revenue tracking

Revenue tracking is optional and off by default. Scheduling works without it. Every tool →

Troubleshooting

If it does not connect

401 Unauthorized

The request reached seenpaid but no valid credential came with it. Check the key starts with sp_, was not revoked, and is sent as “Authorization: Bearer sp_…” with the word Bearer and one space. seenpaid also answers 401 when the workspace has no active trial or plan, even with a correct key.

Wrong URL, or the server never connects

The endpoint is exactly https://api.seenpaid.com/mcp — not seenpaid.com, and not an /sse URL. seenpaid speaks Streamable HTTP only; a client set to SSE will not connect. Opening the URL in a browser shows a short explainer page, which is expected.

OAuth or API key — which one?

Config files and command-line clients send the sp_ key as a header. Connector screens in apps (claude.ai, Claude Desktop, ChatGPT, Grok) have no key field: they sign in to seenpaid with OAuth instead. Never paste your key into an OAuth client ID or secret field.

I use the newer Devin Local agent, not Cascade

Windsurf’s docs (now at docs.devin.ai) say this file configures the Cascade agent only; the Devin Local agent reads MCP servers from the Devin CLI config instead. We have not verified that format, so we do not publish one — add the same URL and Authorization header there by hand.

FAQ

Windsurf and seenpaid, answered

Not on its own — it has no credentials for your accounts. Connected to seenpaid’s MCP server it can schedule and publish to the 21 platforms seenpaid supports, and report back per platform what went out.

Create an API key in seenpaid under Settings → API keys, then add https://api.seenpaid.com/mcp as a remote MCP server with the key sent as an Authorization: Bearer header. Open the MCPs icon at the top of the Cascade panel (or Settings → Cascade → MCP Servers) and edit the raw mcp_config.json. Paste this entry. The docs also accept "url", but "serverUrl" is the key their remote example uses.

Use all 50 seenpaid tools: schedule, edit and cancel posts, check each platform’s limits before publishing, generate images and carousels, and read what published. Revenue tools (which post made money) work only if you switch on revenue tracking, which is optional and off by default.

No. MCP access is included on every seenpaid plan and in the 7-day trial.

It acts through a key or sign-in scoped to one seenpaid workspace; an API key can be revoked in Settings at any time. No tool returns your social passwords or platform tokens, and it cannot connect a new account on its own: it hands you a link and you sign in.

Also works with

Every other setup guide

Same server, same tools. Pick your client for its exact setup.

How the agent works MCP server reference