SuperBooksDevelopers

Set up Windsurf

A JSON file with your key in the header.

The fastest route is still the paste: the agent runs these steps itself.

By hand

1. Add the server to Windsurf's MCP config

Windsurf sends a static header, so it wants a key: mint one at https://app.superbooks.io/settings/developer and put its value where $SUPERBOOKS_API_KEY is below. Do not commit this file.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "superbooks": {
      "serverUrl": "https://api.superbooks.io/mcp",
      "headers": {
        "Authorization": "Bearer $SUPERBOOKS_API_KEY"
      }
    }
  }
}

Verify

Windsurf's MCP panel lists superbooks with its tools, and asking the agent to call the SuperBooks team_get tool returns your team's name.

What the agent can do

45 tools, gated by the credential's scopes: a Read Only key sees the read tier only, and destructive tools need two separate approvals. See Authentication and the API reference.

Windsurf sends a static header, so it uses an API key from https://app.superbooks.io/settings/developer. The raw instructions the agent executes are at /agent-setup/prompt.md; all guides are listed at Onboard your agent.