Get subshack

Connector

Run Subshack from your own AI.

One URL, one sign-in. Your assistant reads your Notes and post analytics, audits any public Substack profile, and — when your account allows it — writes and schedules Notes for you.

https://www.subshack.pro/api/mcp

Sign in with Google or Apple, the same account as the Subshack dashboard. Nothing to paste, nothing to configure. You can revoke the connection from the dashboard at any time.

Add it to your assistant

Claude (web & desktop)

  1. Settings → Connectors → Add custom connector.
  2. Paste the URL above.
  3. Click Connect and sign in.

Claude Code

  1. Run claude mcp add --transport http subshack https://www.subshack.pro/api/mcp
  2. Run /mcp and authenticate.

ChatGPT

  1. Settings → Apps & Connectors → Advanced settings → turn on Developer mode.
  2. Create a connector with the URL above and sign in.
  3. Allow write actions if you want it to publish Notes.

Developer mode is what ChatGPT requires today for a connector that is not yet listed in its directory. It is a beta setting on Plus, Pro, Business, Enterprise and Edu plans, on the web — on a work account an admin may have to allow it first.

Cursor & other MCP clients

  1. Add a remote MCP server with the URL above.
  2. Complete the sign-in your client opens.

Any client that supports remote HTTPS MCP, OAuth discovery, dynamic client registration and PKCE S256 will work. Test yours before relying on it.

What it can and cannot do

It can

  • Read your Notes and post stats — reach, replies, restacks, subscriber attribution.
  • Audit any public Substack profile from its URL, yours or anyone else’s.
  • Tell you how many subscribers an email really reaches, and how many read it.
  • Create, publish, schedule and delete Note drafts, when your account has publishing enabled.

It cannot

  • Follow, subscribe, like or restack — Substack only accepts a real click, and we do not fake one.
  • Give you subscriber email addresses. Ever. You get an opaque reference and a display mask.
  • Publish while your browser is closed — the note waits in the queue instead.
  • See anything you have not synced: the data stops at your last sync, not at today.

Publishing runs through the Subshack Chrome extension, so your Substack session never leaves your machine. That is also why a note can wait: no server of ours can post in your place.

Questions,
answered.

Which AI assistants can I use it with?
Any client that speaks remote MCP over HTTPS with OAuth discovery — Claude (web, desktop and Claude Code), ChatGPT, Cursor, and others. The connector is a standard Streamable HTTP MCP server with Dynamic Client Registration and PKCE, so it is not built for one vendor.
Do I have to paste a token?
No. Paste the connector URL and your client walks you through signing in with Google or Apple — the same account as the Subshack dashboard. A manual token still exists in the dashboard for clients that cannot do OAuth, but it is the fallback, not the normal path.
Can it publish Notes for me?
Yes, if your account has publishing enabled. Your assistant can create a draft, publish a Note, schedule one, and delete a draft. Ask it to show you the exact text first — it posts under your name.
Why does a Note sometimes stay queued?
Because Subshack never holds your Substack session on a server. Publishing is handed to your own browser extension, which posts from your session, on your machine. If your browser is closed the note waits in the queue and goes out when it reopens. Your assistant can check where a command stands at any time.
What can it not do?
It never follows, subscribes, likes or restacks for you — Substack only accepts those from a real click, and we do not fake one. It never returns subscriber email addresses: you get an opaque reference and a display mask, and there is no way to obtain a list.
How do I disconnect it?
Open the Subshack dashboard, find the connection under Connect your AI, and revoke it. Access stops immediately — the connector holds no other credential.