KillerSkills
Sign in
Documentation

MCP Connection

This guide shows how to connect the KillerSkills MCP server to various AI agents and development environments.

Endpoint Details

  • URL: https://killerskills.ai/api/mcp
  • Method: POST
  • Content-Type: application/json
  • Protocol: JSON-RPC 2.0, MCP version 2024-11-05

Connection Handshake

MCP connections start with an initialization handshake to negotiate protocol version and capabilities.

Initialize Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {}
  }
}

Initialize Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {}
    },
    "serverInfo": {
      "name": "killerskills",
      "version": "1.0.0"
    }
  }
}

List Available Tools

After initialization, query available tools:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

Claude Desktop

Add KillerSkills to your Claude Desktop MCP configuration file. The configuration file location depends on your operating system:

  • macOS: ~/Library/Application Support/Claude/mcp_config.json
  • Windows: %APPDATA%\Claude\mcp_config.json
  • Linux: ~/.config/Claude/mcp_config.json

Some versions of Claude Desktop use claude_desktop_config.json instead.

Configuration

{
  "mcpServers": {
    "killerskills": {
      "url": "https://killerskills.ai/api/mcp"
    }
  }
}

After adding this configuration, restart Claude Desktop. KillerSkills will appear in the available MCP servers and Claude will be able to search and retrieve skills and personas.

Claude Code CLI

Add KillerSkills using the mcp add command:

claude mcp add killerskills https://killerskills.ai/api/mcp

Claude Code will automatically connect to the server and make the tools available in your coding sessions.

Cursor

In Cursor, add KillerSkills to your MCP settings:

  1. Open Cursor Settings (Cmd/Ctrl + ,)
  2. Navigate to the MCP section
  3. Add a new MCP server with URL: https://killerskills.ai/api/mcp
  4. Save and restart Cursor

Custom Integration

If you're building a custom MCP client, use the endpoint directly with JSON-RPC 2.0 requests. See the tools reference for complete documentation on available methods and parameters.

Troubleshooting

Connection Refused

Ensure you're using HTTPS and the correct endpoint: https://killerskills.ai/api/mcp

Protocol Version Mismatch

The KillerSkills MCP server uses protocol version 2024-11-05. Ensure your client supports this version or later.

Tools Not Appearing

After updating your configuration, restart the AI agent completely. Configuration changes may not take effect until restart.

Next Steps