Use SelfScale from your AI assistant

MCP (the Model Context Protocol) is the standard way AI assistants connect to other apps. Once you add SelfScale, you can ask your assistant things like “what did my best LinkedIn posts this month have in common?” or “which of my competitors had a breakout video this week?” and it answers from your real SelfScale data.

It works with any MCP client that can send a header with your key, including Claude Code, Claude Desktop, Cursor and VS Code. Every tool is read-only: it looks things up and never posts, edits, deletes or spends credits.

The MCP server comes with Premium and Power.

First-cohort members get the Premium allowance. Change your plan in Settings › Billing.

1. Open SelfScale and go to Settings › Developer.
2. Create a key, give it a name you'll recognize, like “Claude on my laptop”, and choose when it expires: 30 days, 90 days (the default) or a year.
3. Copy the key. It starts with ss_live_ and is shown only once. If you lose it, revoke it and create a new one.

You can have up to 5 active keys. Use a separate key for each app or computer, so you can revoke one without breaking the others.

In each snippet, replace ss_live_your_key_here with your key, or set it in an environment variable where the client supports one.

Claude Code

Run this in your terminal:

claude mcp add --transport http selfscale https://selfscale.app/api/mcp \
  --header "Authorization: Bearer ss_live_your_key_here"

Add --scope user to use SelfScale in every project, not just the current one. Then run /mcp inside Claude Code to check it's connected. To share the setup with a project without committing your key, put this in .mcp.json and set SELFSCALE_API_KEY in your shell:

{
  "mcpServers": {
    "selfscale": {
      "type": "http",
      "url": "https://selfscale.app/api/mcp",
      "headers": {
        "Authorization": "Bearer ${SELFSCALE_API_KEY}"
      }
    }
  }
}

Claude Desktop

Go to Settings › Connectors › Add custom connector and enter the server URL. If the dialog shows a Request headers section, add Authorization with the value Bearer followed by your key. Anthropic is still rolling that section out, so not every account has it yet.

If you don't see it, connect through the mcp-remote bridge instead (needs Node.js). Open Settings › Developer › Edit Config and add:

{
  "mcpServers": {
    "selfscale": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://selfscale.app/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer ss_live_your_key_here"
      }
    }
  }
}

Keep the key in env as shown: some systems split arguments at spaces. Restart Claude Desktop afterwards.

Cursor

Add this to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project), and set SELFSCALE_API_KEY in your environment:

{
  "mcpServers": {
    "selfscale": {
      "url": "https://selfscale.app/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SELFSCALE_API_KEY}"
      }
    }
  }
}

VS Code

Add this to .vscode/mcp.json in your workspace, or run MCP: Open User Configuration to add it for every workspace. VS Code asks for the key the first time the server starts and stores it securely.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "selfscale-key",
      "description": "SelfScale API key",
      "password": true
    }
  ],
  "servers": {
    "selfscale": {
      "type": "http",
      "url": "https://selfscale.app/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:selfscale-key}"
      }
    }
  }
}

ChatGPT

ChatGPT connects to MCP servers through developer mode, which is in beta for some plans. Its connector form signs in with OAuth and has no field for a personal key, so SelfScale can't be added to ChatGPT yet. It will work once sign-in arrives (see Coming soon).

Other clients

Any MCP client that supports Streamable HTTP and custom headers works: point it at https://selfscale.app/api/mcp and send Authorization: Bearer with your key. To call the server from your own code, see the API docs.

Every tool below is read-only and costs no credits. Your assistant picks the right tool from your question, so you rarely need to name one. Tools that call AI or use credits aren't available with a personal key.

{
  "success": true,
  "hasProfile": true,
  "profile": {
    "name": "My voice",
    "active": true,
    "version": 3,
    "updatedAt": "2026-10-02T12:00:00.000Z"
  },
  "voice": {
    "learned": true,
    "rules": [
      "Short sentences.",
      "Open with a concrete number."
    ],
    "signaturePhrases": [
      "Here's the thing"
    ],
    "avoidedWords": [
      "leverage",
      "synergy"
    ]
  },
  "tone": {
    "...": "your tone settings"
  },
  "toneOmitted": false
}

{
  "success": true,
  "hasKit": true,
  "profileName": "My voice",
  "rules": [
    "Always plain English."
  ],
  "neverSay": [
    "game-changer"
  ],
  "soundsLike": [
    "A friendly operator, not a guru."
  ],
  "typography": {
    "...": "your fonts"
  },
  "visualStyles": [
    {
      "title": "Clean desk",
      "body": "..."
    }
  ],
  "updatedAt": "2026-10-01T09:00:00.000Z"
}

{
  "success": true,
  "channels": [
    {
      "channel": "linkedin",
      "connection": {
        "connected": true,
        "account": "yourhandle",
        "via": "oauth",
        "expiresAt": "2026-12-01T00:00:00.000Z"
      },
      "stats": {
        "windowDays": 30,
        "posts": 12,
        "truncated": false,
        "likes": 840,
        "comments": 96,
        "shares": 41,
        "views": 21500,
        "followers": 4210,
        "countCapturedAt": "2026-10-09T06:00:00.000Z"
      }
    }
  ]
}

{
  "success": true,
  "days": 90,
  "sortBy": "views",
  "scanned": 64,
  "posts": [
    {
      "channel": "linkedin",
      "title": "...",
      "url": "https://...",
      "publishedAt": "2026-09-14T15:00:00.000Z",
      "contentType": "text",
      "likes": 410,
      "comments": 52,
      "shares": 19,
      "views": 18200,
      "score": 18200
    }
  ]
}

{
  "success": true,
  "updatedAt": "2026-10-10T08:00:00.000Z",
  "total": 6,
  "creators": [
    {
      "name": "Creator name",
      "platform": "youtube",
      "list": "competitor",
      "profileUrl": "https://www.youtube.com/@...",
      "pinned": false,
      "followers": 182000,
      "followersHidden": false,
      "followersRounded": true,
      "niche": "...",
      "statsStatus": "ok",
      "lastUploadAt": "2026-10-08T17:00:00.000Z",
      "checkedAt": "2026-10-10T08:00:00.000Z",
      "tracked": null,
      "best": {
        "title": "...",
        "url": "https://...",
        "publishedAt": "...",
        "isShort": false,
        "views": 410000,
        "likes": 12000,
        "comments": 800,
        "multiplier": 3.4
      }
    }
  ]
}

{
  "success": true,
  "windowDays": 14,
  "minMultiplier": 3,
  "updatedAt": "2026-10-10T08:00:00.000Z",
  "outliers": [
    {
      "creator": "Creator name",
      "list": "competitor",
      "title": "...",
      "url": "https://...",
      "publishedAt": "...",
      "isShort": true,
      "views": 920000,
      "likes": 41000,
      "comments": 1300,
      "multiplier": 6.1,
      "baselineMedian": 151000,
      "baselineSize": 20
    }
  ]
}

{
  "success": true,
  "hoursBack": 168,
  "stale": false,
  "newestItemAt": "2026-10-10T07:40:00.000Z",
  "items": [
    {
      "platform": "linkedin",
      "text": "...",
      "truncated": false,
      "metrics": {
        "...": "likes, comments, shares"
      },
      "url": "https://...",
      "author": "...",
      "hookType": "contrarian",
      "whyItWorks": "...",
      "createdAt": "2026-10-09T12:00:00.000Z"
    }
  ]
}

{
  "success": true,
  "status": "drafted",
  "drafts": [
    {
      "id": "6f1c...",
      "status": "drafted",
      "channel": "linkedin",
      "title": "...",
      "text": "...",
      "truncated": false,
      "createdAt": "2026-10-09T10:00:00.000Z",
      "updatedAt": "2026-10-09T10:05:00.000Z"
    }
  ]
}

{
  "success": true,
  "plan": {
    "id": "ultimate",
    "name": "Premium"
  },
  "creditsRemaining": 212,
  "monthly": {
    "allocated": 300,
    "rollover": 0,
    "used": 88
  },
  "topUpCredits": 0,
  "periodEndsAt": "2026-11-01T00:00:00.000Z"
}

Daily calls reset at midnight UTC and are shared by all your keys. Every request counts, including the one your client makes to list tools when it connects. Responses carry X-MCP-Limit, X-MCP-Used and X-MCP-Remaining headers.

Request errors

Tool errors

When a tool can't finish, your assistant gets isError: true with a code and a message it can read to you.

• Keys are shown once. SelfScale stores only a hash of each key, so nobody, including us, can show it to you again.
• Revoke anytime. Revoking a key in Settings › Developer stops it on the next request. Revoke a key straight away if it leaks. Every key also expires on the date you picked, at most a year after you made it.
• Scopes. Each key holds scopes that decide what it can do. Personal keys hold the read scope only, so they can read your data but can't post, edit, delete or spend credits.
• Your data only. A key reads only your own account, and the apps you connected yourself.
• Not for browsers. The server refuses requests from web pages on other sites, so a key can't be used from someone else's website. Keep keys out of front-end code and public repos.

• SoonSign in from Claude's connector directory (OAuth). Add SelfScale with one click and sign in, no key to copy.
• SoonWrite tools. Ask your assistant to write a draft, and it lands in your SelfScale approval queue for you to review. Nothing goes out without your approval.