Skip to content
Docs

Start typing to search the documentation.

Search Self docs
from your favorite agent

Plug it into your favorite AI agent to search and integrate the Self documentation — and start building.

MCP https://mcp.self.xyz/mcp

Read the docs. search_docs for semantic search, list_pages for the documentation tree, and get_page to read one page in full. Search to find the page, then read it before writing code.

Run a real verification. create_test_session and get_test_session drive the test-mode emulator, so an agent can prove an integration works instead of only describing it. They need your own sk_test_ key, supplied as a header in the config below — never pasted into a chat.

Start from a prompt. The integrate-self prompt walks an integration end to end, and each Agent Skill is exposed as a readable resource.

One click

These editors publish an install link, so registering the server is a single click:

Claude Code

Run this in your terminal: 

claude mcp add --transport http self https://mcp.self.xyz/mcp

Claude Desktop

Add the server to claude_desktop_config.json: 

{
  "mcpServers": {
    "self": {
      "type": "http",
      "url": "https://mcp.self.xyz/mcp"
    }
  }
}

Cursor

Add the server to ~/.cursor/mcp.json: 

{
  "mcpServers": {
    "self": {
      "type": "http",
      "url": "https://mcp.self.xyz/mcp"
    }
  }
}

Windsurf

Add the server to ~/.codeium/windsurf/mcp_config.json: 

{
  "mcpServers": {
    "self": {
      "type": "http",
      "url": "https://mcp.self.xyz/mcp"
    }
  }
}

Zed

Add the server to settings.json: 

{
  "context_servers": {
    "self": {
      "url": "https://mcp.self.xyz/mcp"
    }
  }
}

JetBrains IDEs

Add the server to Settings → Tools → AI Assistant → Model Context Protocol: 

{
  "mcpServers": {
    "self": {
      "type": "http",
      "url": "https://mcp.self.xyz/mcp"
    }
  }
}

Test sessions

create_test_session and get_test_session need your own test key. Add it as a header on the server entry — the tools take no key argument, so it never reaches a model or a transcript: 

{
  "mcpServers": {
    "self": {
      "type": "http",
      "url": "https://mcp.self.xyz/mcp",
      "headers": {
        "X-Self-Test-Key": "sk_test_..."
      }
    }
  }
}

Test keys only: a key without the sk_test_ prefix is refused before any request is made. Create one in the dashboard under Developers → API keys.

Any other client

Most MCP clients accept this verbatim. The transport is Streamable HTTP and the server needs no authentication. 

{
  "mcpServers": {
    "self": {
      "type": "http",
      "url": "https://mcp.self.xyz/mcp"
    }
  }
}

Clients that support discovery can read the same details from /.well-known/mcp.json . Agents looking for instructions rather than a server should start at /AGENTS.md.