How to Use the Substack MCP in Cursor

Q: How does Cursor access the Substack MCP Server?

You add the server configuration either in your project's .cursor/mcp.json or globally in /.cursor/mcp.json. Just make sure Agent mode is enabled when you start coding.

Q: Can I use Cursor to list recent Substack posts?

Yes, the listposts tool pulls titles and basic data for multiple articles. You can then loop through that array in your code logic immediately after calling the MCP tool.

Q: If I need publication info, should Cursor handle it?

Absolutely. Use getpublicationinfo to fetch metadata like the author name and description. Your generated code can then use this data for display purposes in a front-end framework.

Q: How do I check Substack performance metrics using Cursor?

You call getpoststats and the live JSON response gets injected directly into your editor. This means you're working with production data, not mock responses.

Write code that uses live Substack data right inside Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Substack MCP to Cursor

Create your Vinkius account to connect Substack to Cursor — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Substack with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Inject Live Article Content into Code

The `get_post` tool lets your AI generate working code blocks using real article content. Instead of stubs, you get the actual text from a Substack post, ready to be used in documentation or display logic. This saves massive amounts of time because you don't have to manually copy and paste context into your function.

Build Audience Logic with Cursor

Need to write code that handles subscriber segmentation? Use `list_subscribers` within your agent mode. The AI generates functions that accept real data from the list, letting you build logic based on paid vs. free status. You'll see the live results of the calls injected directly into your file.

Measure Performance for Your App

The `get_post_stats` tool lets your agent pull performance metrics and include them in your code comments or data structures. This is perfect for building internal dashboards or reporting systems. It makes sure that any new feature you write has real-world usage context attached to it.

Setup guide

Set up Substack MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Substack MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Substack transactions." If the MCP tools are loaded correctly, Cursor will call the Substack tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "substack-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Substack. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Substack now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Substack MCP in Cursor

You add the server configuration either in your project's `.cursor/mcp.json` or globally in `~/.cursor/mcp.json`. Just make sure Agent mode is enabled when you start coding.

Yes, the `list_posts` tool pulls titles and basic data for multiple articles. You can then loop through that array in your code logic immediately after calling the MCP tool.

Absolutely. Use `get_publication_info` to fetch metadata like the author name and description. Your generated code can then use this data for display purposes in a front-end framework.

You call `get_post_stats` and the live JSON response gets injected directly into your editor. This means you're working with production data, not mock responses.

The server touches subscriber list data. This includes individual user identifiers and their current subscription status for your Substack publication.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript