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)
- Open Settings, then Connectors, and press Add custom connector.
- Name it Stackblade and paste the server address. Leave the sign-in fields empty.
- 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)
- Open Settings, then Apps and Connectors, then Advanced settings, and turn on Developer mode.
- Back in Apps and Connectors, press Create. Name it Stackblade, paste the server address and choose no authentication.
- 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) andboard(bestsellersorrising). "Who is rising fastest on the technology leaderboard?" recent_activity- Recent leaderboard moves, follower milestones and new recommendations, newest first. Takes
kind:all,rank,recorfollowers. "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
handleandaudience(readerorwriter). 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.