Docs · Reference

MCP server

Ask Claude, ChatGPT, Cursor or VS Code about Substack writers and get answers from Stackblade's data: followers, growth, leaderboard ranks and recommendations, with links to each page. The server reads public data only and changes nothing. No account or sign-in is needed.

Server address: https://stackblade.app/api/mcp

Add it to your assistant

Claude (web and desktop)

  1. Open Settings, then Connectors, and press Add custom connector.
  2. Name it Stackblade and paste the server address. Leave the sign-in fields empty.
  3. In a chat, turn Stackblade on from the tools menu.

On a Team or Enterprise plan, an owner adds the connector for the organization first.

Claude Code

claude mcp add --transport http stackblade https://stackblade.app/api/mcp

ChatGPT (developer mode)

  1. Open Settings, then Apps and Connectors, then Advanced settings, and turn on Developer mode.
  2. Back in Apps and Connectors, press Create. Name it Stackblade, paste the server address and choose no authentication.
  3. In a chat, pick Stackblade from the developer mode menu.

Cursor

Settings, then MCP, then Add new MCP server, or put this in ~/.cursor/mcp.json:

{ "mcpServers": { "stackblade": { "url": "https://stackblade.app/api/mcp" } } }

VS Code

Run MCP: Add Server from the Command Palette, choose HTTP and paste the address, or put this in .vscode/mcp.json:

{ "servers": { "stackblade": { "type": "http", "url": "https://stackblade.app/api/mcp" } } }

Other clients

Any client that speaks the Model Context Protocol over streamable HTTP can connect to the address above. A plain GET on it describes the server. The server card lists the tools.

Tools

get_writer
One writer's followers, change over 7 and 30 days, paid band, leaderboard positions and recommendation counts, with the writer page. Takes handle: a handle, a profile link, a publication address, a custom domain or a name. A writer we do not track gets close matches instead. "How fast is Lenny's Newsletter growing?"
board
The top of a category's Bestsellers or Rising board, with followers, paid band and each writer's move. Takes category (a slug or name) and board (bestsellers or rising). "Who is rising fastest on the technology leaderboard?"
recent_activity
Recent leaderboard moves, follower milestones and new recommendations, newest first. Takes kind: all, rank, rec or followers. "Which writers picked up new recommendations this week?"
list_categories
Every category with a leaderboard, with its slug and page. No arguments. "Which Substack categories have leaderboards?"
get_follow_links
For someone who wants to keep following a writer: the writer page and a link that adds the writer to their watchlist after they confirm on the page. For the writer: a link to claim their page. Also says what the free plan and Pro include. Takes handle and audience (reader or writer). It creates nothing; the person acts on the site. "I want to keep an eye on Heather Cox Richardson's growth." "I write a Substack. How do I claim my page?"

Example questions

  • How many followers does Kyla Scanlon have, and is she growing?
  • Who are the top five writers on the business bestsellers board, and who moved up?
  • Compare the growth of two newsletters I am thinking of sponsoring.
  • Is lennysnewsletter.com on any leaderboard?
  • What happened on the Substack leaderboards today?

What answers contain

Each answer has a short readable summary first, then the same data as JSON. Links are full addresses you can open. Dates are in UTC. Paid subscribers are Substack's band or badge, never an exact count. Free answers show the top of each board and the free activity feed; the pages show the rest.

Heavier use

Light use needs no key. Automated use beyond a small free trial needs a Pro key, sent as Authorization: Bearer <key> by clients that let you add a header. In Claude Code:

claude mcp add --transport http stackblade https://stackblade.app/api/mcp --header "Authorization: Bearer $STACKBLADE_KEY"

When free use runs out for the day, the answer says so and when it starts again.

Privacy

We receive the tool name and its arguments, such as a handle. We never receive your conversation or your account with the assistant. Our analytics record which tool was called, never the arguments. The details are in the privacy policy.

Support

Something wrong or missing? Write to contact@stackblade.app.