Substack MCP server
Newsletter posts and publications on Substack. Add one address to your AI assistant and it can call the 2 tools below itself, with your FoxAPIs key. They cost the same credits as the REST API, and an answer with no data is not charged.
Server address
https://foxapis.com/mcp/data/substack
Streamable HTTP, bearer key in the Authorization header. This address carries only the Substack tools; https://foxapis.com/mcp/data carries all of them, and ?source=substack,github picks several.
What you can ask
Five prompts to give your assistant once the server is added:
- What is the title and subtitle of this Substack post, and how long is it?
- Which publication is this Substack post from, and is it behind a paywall?
- What does the Substack publication at lennysnewsletter.com describe itself as?
- What tags does this Substack post carry?
- Give me the name and description of a Substack publication I link.
The tools your assistant gets
| Tool | What it returns | Inputs | Credits a call |
|---|---|---|---|
substack_post | A Substack post: title, publication, subtitle, word count, tags and paywall type, from its link. | url (required) | 2 |
substack_publication | A Substack publication: name and description, from its address. | url (required) | 2 |
Credits come from the same file as the pricing page. Plans and top-ups are on pricing.
Set it up
Use your FoxAPIs key (it starts with fxp_) as the bearer token. Get one free at foxapis.com/trial.
Claude Code
Run in a terminal. Its docs.
claude mcp add --transport http foxapis-data https://foxapis.com/mcp/data/substack \ --header "Authorization: Bearer YOUR_KEY"
The Claude Code docs show this form (--transport http, name, URL, --header) for a server that takes a bearer token.
Cursor
.cursor/mcp.json in a project, or ~/.cursor/mcp.json for every project. Its docs.
{
"mcpServers": {
"foxapis-data": {
"url": "https://foxapis.com/mcp/data/substack",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Cursor's remote-server example uses a url and a headers object.
VS Code (Copilot)
.mcp.json at the workspace root, or ~/.copilot/mcp-config.json. Its docs.
{
"mcpServers": {
"foxapis-data": {
"type": "http",
"url": "https://foxapis.com/mcp/data/substack",
"headers": {
"Authorization": "Bearer YOUR_KEY"
},
"tools": [
"*"
]
}
}
}Do not store a real key in a file you share.
Cline
cline_mcp_settings.json (open it from Cline's MCP Servers panel). Its docs.
{
"mcpServers": {
"foxapis-data": {
"type": "streamableHttp",
"url": "https://foxapis.com/mcp/data/substack",
"headers": {
"Authorization": "Bearer YOUR_KEY"
},
"disabled": false,
"autoApprove": []
}
}
}Cline's docs say that leaving type out selects the older SSE transport, so keep type.
Zed
settings.json (Zed: open settings). Its docs.
{
"context_servers": {
"foxapis-data": {
"url": "https://foxapis.com/mcp/data/substack",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}
n8n
an MCP Client Tool node in a workflow. Its docs.
Endpoint: https://foxapis.com/mcp/data/substack Server transport: HTTP Streamable Authentication: Header Auth Name: Authorization Value: Bearer YOUR_KEY
Not run by us: the fields are the ones n8n's MCP Client Tool documents. The server speaks Streamable HTTP.
Claude Desktop and ChatGPT
Not covered here: their custom-connector screens ask for sign-in (OAuth) or no authentication, and this server takes a bearer key in a header, so it works best in the clients above. We have not tested it in either.
A real answer
The substack_post tool called once through a real MCP client session on 20 November 2026 with the input {"url":"https://www.lennysnewsletter.com/p/how-to-build-product-sense"}. Long text is cut and lists are cut to three items for display; it is not invented.
{
"url": "https://www.lennysnewsletter.com/p/how-to-build-product-sense",
"platform": "substack",
"extracted_at": "2026-11-20T11:13:49.359304+00:00",
"title": "Lenny's Newsletter | Substack",
"description": "Deeply researched product, growth, and career advice for product leaders, founders, and ambitious builders. Click to read Lenny's Newslet...",
"author_url": "https://www.lennysnewsletter.com",
"date_source": "og_meta",
"thumbnail_url": "https://substackcdn.com/image/fetch/$s_!8MSN!,w_400,h_400,c_fill,f_auto,q_auto:good,fl_progressive:steep,g_auto/https%3A%2F%2Fsubstack-po...",
"content_type": "newsletter_post",
"extras": {
"publication": "www.lennysnewsletter.com",
"paywall_type": "free"
},
"credits_used": 2,
"latency_ms": 688
}
Charged: 2 credits.
Try it free
Runs the substack_post call with the sample input below. No key and no sign-up; a few runs a day per visitor.
{
"url": "https://www.lennysnewsletter.com/p/how-to-build-product-sense"
}
Other data-source MCP servers
Bluesky · Mastodon · Twitch · SoundCloud · Last.fm · Podcasts · all of them
Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.
Get my free keyThe same data over REST: Substack post · Substack publication. More: all MCP servers · people and company tools