Add it
Your client will ask for a remote MCP server URL. This is it:
https://pith.day/api/mcp
Streamable HTTP. Sign-in happens in your browser over OAuth 2.1 — the server issues the token, the client never sees a password of yours.
- Settings → Connectors → Add custom connector.
- Paste the address above and connect.
- Sign in with email or Google when Claude opens pith.day, and approve what it asks for.
- Add it once, then
/mcpto sign in.
claude mcp add --transport http pith https://pith.day/api/mcp
- Add the server to your MCP config:
{
"mcpServers": {
"pith": {
"type": "http",
"url": "https://pith.day/api/mcp"
}
}
}
- Wherever the app asks for a remote MCP server, paste the address.
- Transport: streamable HTTP. Auth: OAuth — Dynamic Client Registration and Client ID Metadata Documents both work, so most clients need no manual setup at all.
First run
whoami— shows nothing is connected yet.connect my instagram— the server hands back a single-use link into Instagram's official login. Approve there, and you land back on a done page.whoamiagain — your account, withcanPublish: true.post this photo with this caption— it is live on Instagram. The reply tells you the exact caption that was posted and links the post.
An Instagram Business or Creator account is required — that is Meta's rule for API publishing, not ours. Switching a personal account over is free and takes a minute in the Instagram app.
What it does
What you actually say
Real sentences, from the mornings this was built for.
How this differs from the other Instagram MCP servers
The tools
The full list, generated from the live server — not a highlight reel. The permission column is what your client is granted at connect time.
Your account
How the assistant finds you and which business it's working on.
The daily drafts
The morning inbox, by chat. This is where most of the day happens.
Publishing
Your own content publishes free; drafts only ever from one you approved. The same rule as the app.
The week ahead
Plan posts by date without opening the calendar.
Your Brand DNA
The voice every draft is written from. Describe the change in words.
Photos & products
The raw material the daily drafts are built from.
Your daily flow
Which loop feeds the mornings. Recycling, a campaign, products, or fresh ideas.
Plan & billing
Read-only, except for handing you a checkout link. Nothing is ever charged by the assistant.
Settings
The switches you'd otherwise hunt for in the app.
View, edit and publish are granted by default; checkout only if a client asks for it. Every connection is listed in Settings → Connected apps on pith.day, and disconnecting cuts it off immediately.
Things worth knowing before you connect
What it costs
The connector is included on every plan, free one included. There is no separate MCP fee and no card needed to start.
Security and privacy
- OAuth 2.1 authorization server run by pith.day: PKCE S256, Dynamic Client Registration, Client ID Metadata Documents, opaque tokens stored hashed.
- Scopes are granular — view, edit, publish, checkout — and shown to you on the approval screen before anything connects.
- Pith reads your Instagram profile and publishes what you ask it to publish. It does not read your DMs, your followers, or anyone else's account.
- Checkout links are handed to you to open. Nothing is ever charged by an assistant.
- Revoke any connection from Settings → Connected apps. It takes effect immediately.
FAQ
No — this repository is the documentation and the manifest for a hosted service. The server itself is the pith.day product. You connect to it; you do not run it.
No. Pith's Meta app is approved at standard access, so any Instagram Business or Creator account can connect through the normal Instagram login.
Not today. Instagram stories, feed posts, carousels and reels are what it does.
Anything that speaks remote MCP over streamable HTTP with OAuth: Claude and Claude Code, Cursor, VS Code, and a growing list of others.
The post is written down before it is sent, so a retry resumes the same post instead of creating a second one. Carousels in particular are not idempotent on Instagram's side, and this is handled.
First-class. The product was built in Hebrew and English, and generated story text renders correctly in both.
Connect it
Two minutes, once. Publish your own content free, and see whether the drafts earn their place.