What is the Toopost MCP server?

A remote Model Context Protocol server at https://mcp.toopost.us that connects an AI client to your Toopost inbox with nine tools: search, ask (AI answers with citations), list_feed, get_document, list_sources, list_saved and list_alerts read it; follow_source and save_document follow a source and save a post. It uses streamable HTTP and OAuth 2.1 with PKCE.

Which clients work with it?

Any MCP client that supports remote servers over streamable HTTP: Claude (web and desktop), ChatGPT connectors, Claude Code, Cursor, VS Code, Windsurf and custom agents built with the MCP SDKs.

Which plan do I need?

Connecting AI agents through MCP requires the Maxi plan ($15 a month or $150 a year). Every account starts on Free; upgrade in the app under Plans.

Can the agent add sources or publish?

It can follow a source (follow_source) and save a post (save_document). It cannot unfollow, edit posts, publish or change your account. To unfollow sources from an agent, use the toopost CLI or the REST API with a scoped token.

Is there an MCP server for Pro?

Yes, a local one. The toopost CLI runs an MCP server on your machine (npx toopost mcp) for Claude Code, Cursor and Codex. It needs Pro or Maxi, like the CLI. Add it with claude mcp add toopost -- npx -y toopost mcp, or run npx toopost skills --mcp in a project.

How do I revoke access?

Disconnect the client in its own settings and revoke the token in Toopost under Connections → AI agents. Disconnecting does not delete copies the AI provider already holds; see the privacy policy.

Your trusted sources, inside Claude and ChatGPT

The Toopost MCP server is a remote Model Context Protocol server that lets any MCP client search, read and ask the sources you follow, with full text, dates and citations, instead of guessing from a web search. It can also follow a source and save a post.

Create an account See Maxi

Updated October 15, 2026 · facts mirror the app

MCP server

Remote server at https://mcp.toopost.us, streamable HTTP, OAuth 2.1 with dynamic client registration and PKCE. Maxi. Nine tools: seven read your inbox, two act on it (follow a source, save a post).

Claude (web and desktop)

Settings → Connectors → Add custom connector, paste the URL, sign in.

https://mcp.toopost.us

ChatGPT

Settings → Connectors → Create, paste the URL as a remote MCP server (streamable HTTP), sign in.

https://mcp.toopost.us

Claude Code

One command, then /mcp to sign in.

claude mcp add --transport http toopost https://mcp.toopost.us

Cursor

Add to .cursor/mcp.json. Create an MCP token in Connections → AI agents.

{
  "mcpServers": {
    "toopost": {
      "url": "https://mcp.toopost.us",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

VS Code

Add to .vscode/mcp.json or your user settings.

{
  "servers": {
    "toopost": {
      "type": "http",
      "url": "https://mcp.toopost.us",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

Tools

Tool	Parameters	What it does
search	q, since, source_ids, list_id, limit, cursor	Full-text search over your sources. Supports site:, from:, after:, before: and "phrases".
ask	question, scope, history	AI answer from your sources with numbered citations. Uses your monthly AI usage.
list_feed	since, until, source_ids, list_id, unread, sort, limit, cursor	Latest posts in your inbox, newest first.
get_document	id	One post with its extracted full text.
list_sources		Sources you follow.
list_saved	collection_id, q, limit, cursor	Saved posts, newest saved first.
list_alerts	unread, limit, cursor	Alerts from monitored saved searches.
follow_source	canonical_url, name, list_id, trust, strategy	Follow a site, feed or channel by its address.writes
save_document	document_id, note, collection_id	Save a post, with an optional note or collection.writes

Local MCP server for coding agents (Pro or Maxi)

The toopost CLI runs its own MCP server on stdin/stdout: npx toopost mcp. It signs in with a link and a code (the agent calls toopost_login and shows them to you), so it works in Claude Code, Cursor and Codex without OAuth support in the client.

Claude Code

claude mcp add toopost -- npx -y toopost mcp

Claude Code, Cursor and Codex in one project

Writes a Toopost skill, a Cursor rule and an AGENTS.md section, and adds the server to .mcp.json and .cursor/mcp.json.

npx toopost skills --mcp

Codex

Add to ~/.codex/config.toml.

[mcp_servers.toopost]
command = "npx"
args = ["-y", "toopost", "mcp"]

Tool	Arguments	What it does
toopost_login		Returns a link and a code to approve in the browser; sign-in finishes in the background.
toopost_whoami		Email and plan.
toopost_usage		Plan, AI usage percent and reset date, sources and saves.
toopost_feed	since, source, folder, unread, limit	Latest posts.
toopost_search	q, since, source, folder, limit	Full-text search.
toopost_ask	question, since, source, folder, saved, post	AI answer from your sources with citations.
toopost_read	id, fetch	One post with its full text.
toopost_saved	search, limit	Saved posts.
toopost_save / toopost_unsave	id	Save or unsave a post.
toopost_sources		Followed sources.
toopost_add_source / toopost_remove_source	url, name / id	Follow a URL or unfollow by id.
toopost_alerts	unread, limit	Alerts from monitored searches.

Prompts for MCP clients

Daily digest

Summarize what's new in my Toopost feed since yesterday, grouped by topic, with a source link for each item.

Research a topic

Find articles about [topic] from my Toopost sources this week and give me 5 key takeaways with links.

Compare coverage

Compare how my Toopost sources covered [topic]: where they agree, where they differ, and what evidence each cites.

Coding agents (CLI)

Use the toopost CLI to read my feed: run `toopost feed --json --since 24h`, pick the 5 most important posts, read each with `toopost read <id> --json`, and give me a short briefing with links. If a command exits with code 3, run `toopost login --json`, show me the link and the code from its first line, wait until I approve, then retry.

MCP FAQ

What is the Toopost MCP server?: A remote Model Context Protocol server at https://mcp.toopost.us that connects an AI client to your Toopost inbox with nine tools: search, ask (AI answers with citations), list_feed, get_document, list_sources, list_saved and list_alerts read it; follow_source and save_document follow a source and save a post. It uses streamable HTTP and OAuth 2.1 with PKCE.
Which clients work with it?: Any MCP client that supports remote servers over streamable HTTP: Claude (web and desktop), ChatGPT connectors, Claude Code, Cursor, VS Code, Windsurf and custom agents built with the MCP SDKs.
Which plan do I need?: Connecting AI agents through MCP requires the Maxi plan ($15 a month or $150 a year). Every account starts on Free; upgrade in the app under Plans.
Can the agent add sources or publish?: It can follow a source (follow_source) and save a post (save_document). It cannot unfollow, edit posts, publish or change your account. To unfollow sources from an agent, use the toopost CLI or the REST API with a scoped token.
Is there an MCP server for Pro?: Yes, a local one. The toopost CLI runs an MCP server on your machine (npx toopost mcp) for Claude Code, Cursor and Codex. It needs Pro or Maxi, like the CLI. Add it with claude mcp add toopost -- npx -y toopost mcp, or run npx toopost skills --mcp in a project.
How do I revoke access?: Disconnect the client in its own settings and revoke the token in Toopost under Connections → AI agents. Disconnecting does not delete copies the AI provider already holds; see the privacy policy.

Prefer a terminal? See the toopost CLI. Building your own integration? See the REST API.