Your trusted sources, inside Claude and ChatGPT
The Toopost MCP server is a remote, read-only Model Context Protocol server that lets any MCP client search and read the sources you follow, with full text and dates, instead of guessing from a web search.
Updated · facts mirror the app
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.usChatGPT
Settings → Connectors → Create, paste the URL as a remote MCP server (streamable HTTP), sign in.
https://mcp.toopost.usClaude Code
One command, then /mcp to sign in.
claude mcp add --transport http toopost https://mcp.toopost.usCursor
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 returns |
|---|---|---|
| search_posts | query, limit | Full-text search over your sources. |
| get_post_content | post_id | Full text of one post. |
| get_posts | limit, page, feed_id, tag, read_status, search | Recent posts, filterable by source and date. |
| get_feeds | Your sources. | |
| get_saved_posts | limit, page | Saved posts. |
| get_liked_posts | limit, page | Liked posts. |
| get_recent_interactions | limit, type | What you read, saved and liked recently. |
| analyze_trends | time_range, category | Topics that are rising across your sources. |
| get_user_stats | Aggregate account statistics. | |
| search / fetch | query / id | ChatGPT deep-research compatible pair. |
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.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`.MCP FAQ
- What is the Toopost MCP server?
- A remote Model Context Protocol server at https://mcp.toopost.us that lets an AI client read your Toopost inbox: search posts, fetch full text, list sources, read saved posts and analyze trends. It uses streamable HTTP and OAuth 2.1 with PKCE, and it is read-only.
- 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?
- No. The MCP integration is read-only. To follow or unfollow sources from an agent, use the toopost CLI or the REST API with a scoped token.
- 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.