Which plan do I need?

The hosted MCP server at mcp.toopost.us requires Maxi. The CLI, its local MCP server (npx toopost mcp) and API tokens require Pro or Maxi. Every account starts on Free; upgrade in the app when you want to connect an agent.

Can an agent change my data?

Only in small ways. The hosted MCP server reads posts, sources, saved posts and alerts, and two tools act on your account: follow_source follows a site or channel and save_document saves a post. The CLI and its local MCP server can also unsave posts and unfollow sources; its instructions tell the agent to ask before changes. Neither edits posts, publishes or touches billing. API tokens have scopes you choose.

How does sign-in work?

MCP uses OAuth 2.1 with dynamic client registration and PKCE. The CLI prints a link and a code that you approve in the browser, so it works over SSH and inside coding agents and no secret is typed into the terminal (toopost login --browser keeps the older loopback flow). CLI tokens last 90 days and renew while in use. Headless agents and CI pass an API token as TOOPOST_TOKEN.

What does an agent see?

Only what the tools it calls return: titles, article text, URLs, dates, authors, saved posts, alerts and AI answers from the sources you follow. You can revoke any token in Connections at any time.

Give your agent sources you trust

Toopost keeps a fresh, deduplicated, full-text inbox of the sources you chose. Claude, ChatGPT, Claude Code, Cursor, Codex and scripts read it through the hosted MCP server, the toopost CLI and its local MCP server, or the REST API.

Create an account MCP setup

Updated October 15, 2026 · facts mirror the app

Connect AI agents to your trusted sources

The same inbox, three doors. An agent gets fresh, deduplicated, full-text posts from sources you chose, instead of whatever a web search returns.

MCP server

Hosted at mcp.toopost.us for Claude, ChatGPT, Claude Code, Cursor, VS Code or any client with streamable HTTP. OAuth sign-in, Maxi. Nine tools: search, ask, list_feed, get_document, list_sources, list_saved, list_alerts, follow_source, save_document.

mcp.toopost.us ↗

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

toopost CLI

One npm package, Pro or Maxi. npx toopost opens an arrow-key menu; sign in with a link and a code, even over SSH. Every command works with --json, toopost mcp is a local MCP server, and toopost skills --mcp sets up Claude Code, Cursor and Codex.

npm: toopost ↗

npx toopost

REST API

API tokens for Pro and Maxi, with every endpoint and a curl example in the app under Connections → API. Send posts to webhooks, receive pushes through a webhook inbox, schedule automations.

curl -H "Authorization: Bearer $TOOPOST_TOKEN" https://go.toopost.us/api/user/v2/feed?since=24h

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.

toopost CLI

npm package toopost. Version 0.3.0, Node 18.18 or newer. Pro or Maxi. Every command has --json; errors go to stderr with stable codes and exit codes (3 NOT_LOGGED_IN, 4 PLAN_REQUIRED, 5 NOT_FOUND, 6 LIMIT, 7 NETWORK).

Menu and sign-in

npx toopost                # arrow-key menu
toopost login              # prints a link and a code, approve in the browser
toopost feed --since 24h

AI agents

npx toopost skills --mcp   # Claude Code, Cursor, AGENTS.md
claude mcp add toopost -- npx -y toopost mcp

Headless agents and CI

export TOOPOST_TOKEN=...   # API token with All permissions
toopost feed --json --since 6h | jq '.items[] | .title'

toopost	Arrow-key menu: sign in, today's main stories, ask, feed, search, saved, sources, AI usage, install into your AI agent
toopost login	Prints a link and a code to approve in the browser. Works over SSH and inside coding agents. --browser for the loopback flow, --token for an API token
toopost feed	Posts from your sources, newest first. --since 24h, --source, --folder, --unread, --search, --limit
toopost read <id>	One post with its full text. --fetch downloads the page when the text is missing
toopost search <query>	Full-text search. Quotes, -exclude, site:host and dates like "last week"
toopost ask "<question>"	AI answer over your sources, streamed, with numbered citations
toopost saved · save <id> · unsave <id>	Saved posts
toopost sources · sources add <url> · sources remove <id>	Follow a site, feed, Telegram, YouTube or Reddit channel
toopost alerts	Alerts from monitored searches. --unread, --limit
toopost usage · whoami	Plan, AI usage percent and reset date
toopost skills --mcp	Set up Claude Code, Cursor and Codex in this folder
toopost mcp	Local MCP server on stdin/stdout for AI agents

REST API

Create a token in Connections → API with the scopes you need. Every endpoint of API v2 (go.toopost.us/api/user/v2) is listed on the same page with a copyable curl example. Automations, webhooks and the webhook inbox are configured in the app.

curl -H "Authorization: Bearer $TOOPOST_TOKEN" "https://go.toopost.us/api/user/v2/search?q=site:arxiv.org+after:2026-10-01"

Prompts that work

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.

FAQ

Which plan do I need?: The hosted MCP server at mcp.toopost.us requires Maxi. The CLI, its local MCP server (npx toopost mcp) and API tokens require Pro or Maxi. Every account starts on Free; upgrade in the app when you want to connect an agent.
Can an agent change my data?: Only in small ways. The hosted MCP server reads posts, sources, saved posts and alerts, and two tools act on your account: follow_source follows a site or channel and save_document saves a post. The CLI and its local MCP server can also unsave posts and unfollow sources; its instructions tell the agent to ask before changes. Neither edits posts, publishes or touches billing. API tokens have scopes you choose.
How does sign-in work?: MCP uses OAuth 2.1 with dynamic client registration and PKCE. The CLI prints a link and a code that you approve in the browser, so it works over SSH and inside coding agents and no secret is typed into the terminal (toopost login --browser keeps the older loopback flow). CLI tokens last 90 days and renew while in use. Headless agents and CI pass an API token as TOOPOST_TOKEN.
What does an agent see?: Only what the tools it calls return: titles, article text, URLs, dates, authors, saved posts, alerts and AI answers from the sources you follow. You can revoke any token in Connections at any time.

Create an account Compare plans