developer docs

Integrate skil.ski with any AI client.

One MCP endpoint. Every Skilski. Works with Claude Desktop, Cursor, ChatGPT, and 30+ other MCP-aware agents. Add the URL once — your skills load automatically and stay in sync as new flagships verify.

POSThttps://skil.ski/api/mcplive

Quickstart →

59Verified flagships

2,548catalog tools

JSON-RPC 2.0open standard

~120msmedian tools/list

reference

What MCP is, how JSON-RPC calls work against the skil.ski endpoint, authentication, rate limits, and error codes.

Read the protocol →

format

SKILL.md format

YAML frontmatter fields, body structure, validation rules, and an annotated example for SKILL.md files.

See the format →

reference

OpenAPI catalog

Machine-readable catalog spec, live endpoint link, and authentication details for REST integrations.

View OpenAPI →

sample request

First call, end-to-end.

Standard MCP tools/list against the live endpoint returns every Skilski you can call from your account.

json · requesttools-list-request.json

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

json · response (truncated)tools-list-response.json

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "skilski__pwfa-pumping-rights",
        "description": "Apply PUMP Act + state extensions...",
        "inputSchema": { "type": "object", "properties": {...} }
      },
      {
        "name": "skilski__bsa-ctr-10000-aggregation-rule",
        "description": "BSA CTR aggregation across same-day...",
        "inputSchema": { "type": "object", "properties": {...} }
      }
      // … plus every tool your tier unlocks
    ]
  }
}

before you start

Three things you need.

You can finish all three in under five minutes. The free tier is enough to try every public Skilski and run the Quickstart end-to-end.

A skil.ski account

Free tier is enough to start.

An MCP token

Generated in your SkiLodge — rotate at any time.

Open lodge →

An MCP-aware AI client

Claude Desktop, Cursor, or any JSON-RPC 2.0 client.

See compatible agents →

error reference

Errors you will see in production.

Every error returns a JSON-RPC body with a numeric code, a human message, and (when applicable) a retryAfterMs hint. Honor it.

-32700

Parse error

Body is not valid JSON. Check your client serialization.

-32601

Method not found

Method is not exposed at the skil.ski MCP root. See protocol reference.

401

Unauthorized

Missing or rotated MCP token. Generate a new one in /lodge.

429

Rate limited

Sliding-window cap per tier. Honor the Retry-After header — rate windows reset on a 60s rolling clock.

503

Capability disabled

Operator-paused for maintenance. The error body lists ETA + alternatives.

compatible clients

Works in 12+ AI clients.

MCP is the open standard. If your client speaks MCP, the skil.ski endpoint works without custom plumbing.

Claude DesktopClaude CodeCursorWindsurfContinueClineZedChatGPT (custom GPTs)GooseSourcegraph CodyReplit AgentJetBrains AI Assistant+18 more — any JSON-RPC 2.0 MCP client

Need help? Reach the support team →

Changelog Trust & security Start the quickstart →

developer docs

Integrate skil.ski with any AI client.

POSThttps://skil.ski/api/mcplive

Quickstart →

59Verified flagships

2,548catalog tools

JSON-RPC 2.0open standard

~120msmedian tools/list

reference

What MCP is, how JSON-RPC calls work against the skil.ski endpoint, authentication, rate limits, and error codes.

Read the protocol →

format

SKILL.md format

YAML frontmatter fields, body structure, validation rules, and an annotated example for SKILL.md files.

See the format →

reference

OpenAPI catalog

Machine-readable catalog spec, live endpoint link, and authentication details for REST integrations.

View OpenAPI →

sample request

First call, end-to-end.

Standard MCP tools/list against the live endpoint returns every Skilski you can call from your account.

json · requesttools-list-request.json

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

json · response (truncated)tools-list-response.json

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "skilski__pwfa-pumping-rights",
        "description": "Apply PUMP Act + state extensions...",
        "inputSchema": { "type": "object", "properties": {...} }
      },
      {
        "name": "skilski__bsa-ctr-10000-aggregation-rule",
        "description": "BSA CTR aggregation across same-day...",
        "inputSchema": { "type": "object", "properties": {...} }
      }
      // … plus every tool your tier unlocks
    ]
  }
}

before you start

Three things you need.

You can finish all three in under five minutes. The free tier is enough to try every public Skilski and run the Quickstart end-to-end.

A skil.ski account

Free tier is enough to start.

An MCP token

Generated in your SkiLodge — rotate at any time.

Open lodge →

An MCP-aware AI client

Claude Desktop, Cursor, or any JSON-RPC 2.0 client.

See compatible agents →

error reference

Errors you will see in production.

Every error returns a JSON-RPC body with a numeric code, a human message, and (when applicable) a retryAfterMs hint. Honor it.

-32700

Parse error

Body is not valid JSON. Check your client serialization.

-32601

Method not found

Method is not exposed at the skil.ski MCP root. See protocol reference.

401

Unauthorized

Missing or rotated MCP token. Generate a new one in /lodge.

429

Rate limited

Sliding-window cap per tier. Honor the Retry-After header — rate windows reset on a 60s rolling clock.

503

Capability disabled

Operator-paused for maintenance. The error body lists ETA + alternatives.

compatible clients

Works in 12+ AI clients.

MCP is the open standard. If your client speaks MCP, the skil.ski endpoint works without custom plumbing.

Claude DesktopClaude CodeCursorWindsurfContinueClineZedChatGPT (custom GPTs)GooseSourcegraph CodyReplit AgentJetBrains AI Assistant+18 more — any JSON-RPC 2.0 MCP client

Need help? Reach the support team →

Changelog Trust & security Start the quickstart →