Skip to content
tōōpost
Get started

Give your agent sources you trust

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

Create an accountMCP setup

Updated · 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

Claude, ChatGPT, Claude Code, Cursor, VS Code or any client with streamable HTTP. OAuth sign-in, read-only tools: search_posts, get_post_content, get_posts, get_feeds, get_saved_posts, analyze_trends.

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

toopost CLI

One npm package, no runtime dependencies. Run it once: it signs you in and opens a menu with feed, search, ask, saved and sources. Every command also works non-interactively with --json for scripts and coding agents.

npm: toopost ↗
npx toopost

REST API

API tokens with scopes, a live Swagger UI and an OpenAPI 3.0 spec your agent can read. Send posts to webhooks, receive pushes through a webhook inbox, schedule automations.

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

MCP server

Remote server at https://mcp.toopost.us, streamable HTTP, OAuth 2.1 with dynamic client registration and PKCE. Read-only.

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

ToolParametersWhat it returns
search_postsquery, limitFull-text search over your sources.
get_post_contentpost_idFull text of one post.
get_postslimit, page, feed_id, tag, read_status, searchRecent posts, filterable by source and date.
get_feedsYour sources.
get_saved_postslimit, pageSaved posts.
get_liked_postslimit, pageLiked posts.
get_recent_interactionslimit, typeWhat you read, saved and liked recently.
analyze_trendstime_range, categoryTopics that are rising across your sources.
get_user_statsAggregate account statistics.
search / fetchquery / idChatGPT deep-research compatible pair.

toopost CLI

npm package toopost. Node 18.18 or newer, no runtime dependencies. Every command has --json; errors go to stderr with stable exit codes (3 = not signed in, 4 = plan, 6 = limit).

Install and sign in
npx toopost login          # opens the browser, approve "Toopost CLI"
toopost whoami
toopost feed --since 24h
Headless agents and CI
export TOOPOST_TOKEN=...   # API token with All permissions
toopost feed --json --since 6h | jq '.items[] | .title'
toopost feedPosts 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 usage · whoamiPlan, AI usage percent and reset date

REST API

Create a token in Connections → API with the scopes you need. Browse every endpoint in the Swagger UI or load the OpenAPI 3.0 JSON into your agent. Automations, webhooks and the webhook inbox are configured in the app.

curl -H "Authorization: Bearer $TOOPOST_TOKEN" "https://go.toopost.us/api/search/v2?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.

CLI briefing (coding agents)

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, ask me to run `toopost login`.

FAQ

Which plan do I need?
MCP requires Maxi. The CLI 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?
MCP is read-only: it searches and reads posts, sources, saved posts and statistics. It does not add sources, edit posts or publish. The CLI can also follow and unfollow sources and save posts. API tokens have scopes you choose.
How does sign-in work?
MCP uses OAuth 2.1 with dynamic client registration and PKCE. The CLI uses OAuth Authorization Code with PKCE and a loopback redirect, so no secret is typed into the terminal. 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 and aggregates from the sources you follow. You can revoke any token in Connections at any time.
Create an accountCompare plans