MCP

SUPERWISE® publishes two Model Context Protocol (MCP) servers for reading the SUPERWISE documentation inside an AI assistant or code editor, such as Cursor, Windsurf, Claude Desktop, Claude Code, or Codex. Add them, and the assistant answers questions about SUPERWISE from these docs and the Python SDK reference instead of from memory.

What is MCP?

Model Context Protocol (MCP) is an open standard that lets an AI assistant read from outside sources and call outside tools. The SUPERWISE MCP servers give the assistant:

• Documentation search across the user guides, the REST API reference, and the Python SDK reference
• Code examples drawn from those pages, for HTTP calls and for the superwise_api package

Available servers

Both servers speak streamable HTTP MCP and need no sign-in to read the public docs.
The docs server can also send a REST API request if you add your own SUPERWISE
credentials in your MCP client. Without them, both servers read documentation only.

Which one should I use?

Most editors can register multiple MCP servers at once — keep both enabled and
your editor will pick the right one per question. A rough guide:

• Writing Python (import superwise_api, pip install superwise-api, class
  and schema reference) → Python SDK Reference server.
• Calling REST endpoints, generating curl examples, or asking about product
  concepts (policies, dashboards, agents, guardrails) → API & User Guides server.

Setup

SUPERWISE Docs: REST API & User Guides

SUPERWISE hosts a remote MCP server at https://docs.superwise.ai/mcp. Add it to your AI tool with one of the configurations below. Each one names the server superwise-docs; any name works.

{
  "mcpServers": {
    "superwise-docs": {
      "url": "https://docs.superwise.ai/mcp"
    }
  }
}

{
  "mcpServers": {
    "superwise-docs": {
      "url": "https://docs.superwise.ai/mcp"
    }
  }
}

{
  "mcpServers": {
    "superwise-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.superwise.ai/mcp"]
    }
  }
}

[mcp_servers.superwise-docs]
command = "npx"
args = ["-y", "mcp-remote", "https://docs.superwise.ai/mcp"]

SUPERWISE Python SDK Reference

{
  "mcpServers": {
    "superwise-sdk-docs": {
      "url": "https://mcp.sdk.docs.superwise.ai/mcp"
    }
  }
}

{
  "mcpServers": {
    "superwise-sdk-docs": {
      "url": "https://mcp.sdk.docs.superwise.ai/mcp"
    }
  }
}

{
  "mcpServers": {
    "superwise-sdk-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.sdk.docs.superwise.ai/mcp"]
    }
  }
}

[mcp_servers.superwise-sdk-docs]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.sdk.docs.superwise.ai/mcp"]

Testing Your MCP Setup

Once configured, you can test your MCP server connection:

1. Open your AI editor (Cursor, Windsurf, etc.)
2. Start a new chat with the AI assistant
3. Ask about SUPERWISE Docs or SDK - try questions like:
   • "Using the SUPERWISE Python SDK, show me how to create a Policy."
   • "List the available Dashboard methods in superwise_api."
   • "Using the SUPERWISE REST API, how do I POST a new agent?"

The assistant should now answer from the SUPERWISE documentation through the MCP servers.