Community Archive Connector
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Community Archive Connector Find my first tweet about build in public and give me a receipt."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Community Archive connector
An MCP server for the Community Archive, the open database of uploaded Twitter/X archives. It runs two ways from the same code:
Hosted connector (Cloudflare Worker). People paste one URL into Claude, click Connect, and enter their own Community Archive API key on a sign-in page. Nothing to install.
Local server (stdio). For people who'd rather run it on their own machine.
Both use the archive's keyed API v1 (https://analytics.community-archive.org/v1). The legacy Supabase REST API is retired on 2026-11-19 and isn't used.
Try it
A hosted instance is running at:
https://community-archive-mcp.leo-guinan.workers.dev/mcpIn Claude, go to Customize → Connectors → Add custom connector, paste that URL, click Connect, and enter your key from community-archive.org/settings/api-keys. Then ask something like "Find my first tweet about build in public and give me a receipt."
This is an independent project, not an official Community Archive service. The plan is to hand it to the Community Archive maintainers (HANDOFF.md).
Receipts become videos and stickers with the receipt-video example.
Related MCP server: twitterapis
Tools
All tools are read-only.
API v1
Tool | Route | Notes |
|
| The key and its limits. |
|
| 1–100 IDs or status URLs; reports which are missing. |
|
| Full text, |
|
| Accepts |
|
| Order, date range, skip replies/retweets, several pages per call. |
|
| Everything in a window of up to 31 days. |
|
| Archive-derived edges. |
|
| Current members. |
Tweets come back compact by default (id, permalink, user, date, text with t.co links expanded, counts, reply and quote pointers). Pass format: "full" for every API field.
Built on top
Tool | What it does |
| Dated proof record of up to 25 tweets: exact text, timestamp, permalink, author, a SHA-256 over |
| The reply chain above a tweet plus the author's own continuation below it. Notes parents that aren't in the archive. |
| Earliest archived uses of a phrase, overall or by one person. Says when the scan was incomplete. |
| Counts per day, week, month or year, with first and latest use and top authors. Covers what the retired |
| People ranked by how often they tweet about a topic, with first mention and best-received tweet. |
| People by partial name or handle: fuzzy, accent-insensitive, over the member list (v1 has no account search). |
| Shared followers or following between two accounts, with Jaccard similarity. |
Using the hosted connector
In Claude: Customize → Connectors → Add custom connector, paste https://<host>/mcp, then Connect. A page asks for your key (create one here). On Team and Enterprise plans an Owner adds the connector first, under Organization settings → Connectors, and each member then connects with their own key.
Claude Code:
claude mcp add --transport http community-archive https://<host>/mcpClients that can't do OAuth can send the key directly: Authorization: Bearer cak_.... See How sign-in works for the trade-off.
Running locally (stdio)
npm install && npm run build
CA_API_KEY=cak_... node dist/stdio.jsOr point CA_ENV_FILE at a dotenv file containing CA_API_KEY or COMMUNITY_ARCHIVE_API_KEY, which keeps the key out of client config. Claude desktop:
"community-archive": {
"command": "node",
"args": ["/ABSOLUTE/PATH/dist/stdio.js"],
"env": { "CA_ENV_FILE": "~/.config/community-archive/.env" }
}How sign-in works
The hosted connector is its own OAuth 2.1 authorization server, built on @cloudflare/workers-oauth-provider:
Claude's request to
/mcpgets a401pointing at the server's metadata.Claude registers itself, either with a Client ID Metadata Document ("Use Claude's published identity") or Dynamic Client Registration ("Register automatically"). Both are supported.
The user lands on
/authorize, which shows the app asking, where access will be sent, and a field for their key.The server checks the key with
GET /v1/me. A wrong or malformed key brings the page back with an error.The key is stored only inside the grant's
props, which the library encrypts with a key that only that grant's tokens can unwrap. Tokens are stored only as hashes. Claude receives its own access and refresh tokens, never the archive key.Each MCP request decrypts the key and calls the archive with it.
Direct keys. With ALLOW_DIRECT_KEYS on, /mcp also accepts Authorization: Bearer cak_.... The key is checked against /v1/me (remembered for five minutes by a hash) and used for that request only. This is token passthrough, which the MCP authorization spec discourages; it exists for scripts and clients without OAuth. Set ALLOW_DIRECT_KEYS to "false" to turn it off.
Limits. Every call counts against the user's own key (60 a minute, 20,000 a day). The hosted server retries 429/503 briefly, then reports the limit to the assistant rather than waiting. Archive responses are public and identical across keys, so isolates share a short in-memory cache.
Examples
examples/receipt-video turns ca_receipt output into a printed-receipt MP4, with the timestamp highlighted and a QR code that opens the original post, and into a die-cut sticker PNG. It also renders a demo video of the whole flow.
Development
npm test # unit tests: every tool against an in-memory fake of API v1
npm run test:e2e # runs the Worker locally and walks the whole connect flow (17 checks)
npm run typecheck # both the Node and the Worker buildsThe end-to-end test starts wrangler dev --env test against a mock archive on port 8798 and checks discovery, registration, the key page, wrong and malformed keys, PKCE token exchange, MCP calls, refresh, direct keys, cancel, forged forms, unregistered redirects, and that the plaintext key never appears in KV storage or logs.
Deploying: DEPLOY.md. Privacy policy: PRIVACY.md. Handing the project to the Community Archive team: HANDOFF.md.
License
MIT
Available Tools
15 toolsca_accountLook up accountsBRead-only
Profile and membership flags for one account, or for up to 100 by usernames or IDs.
Inputs: ids, account, usernames.
ca_account_relationsLikes and followsBRead-only
Archive-derived likes, followers, or following for an account. Cursor-paged, up to 500 per page.
Inputs: kind (required), account (required), limit, cursor, +1 more.
ca_account_tweetsAccount timelineARead-only
An account's tweets in time order, optionally within a date range and without replies or retweets. Cursor-paged, up to 200 per page.
Inputs: account (required), limit, order, since, +6 more.
ca_find_peopleFind peopleARead-only
Find archive members by partial name or handle (fuzzy, accent-insensitive). Falls back to a direct account lookup for exact handles of non-members.
Inputs: query (required), limit.
ca_first_saidFirst saidARead-only
Find the earliest archived tweets containing a word or phrase, overall or by one person. Answers 'when did I first say X' and 'who said it first'.
Inputs: q (required), n, scan, since, +3 more.
ca_get_tweetsGet tweetsARead-only
Fetch tweets by ID or x.com/twitter.com status URL (1–100), returned in request order. Missing IDs were deleted, opted out, or never archived.
Inputs: refs (required), format.
ca_meKey and limitsARead-only
Show the calling API key's identity and rate limits.
Inputs: no named parameters.
ca_membersMembersBRead-only
Current Community Archive members (people who uploaded their archive). Cursor-paged, up to 1,000 per page.
Inputs: limit, cursor, max_pages.
ca_phrase_timelinePhrase timelineARead-only
Count how often a word or phrase appears per day, week, month, or year, with first and latest use and top authors. Useful for tracing how an idea spread.
Inputs: q (required), scan, since, until, +3 more.
ca_receiptReceipt for a tweetARead-only
Turn tweets into dated proof records: exact text with links expanded, timestamp, permalink, author, and a SHA-256 over kind|date|url|quote (the Receipt Cuts format), plus the API request_id as provenance.
Inputs: refs (required).
ca_relation_overlapFollow overlapBRead-only
Compare two accounts' followers or following: shared accounts and Jaccard similarity, from archive-derived edges.
Inputs: a (required), b (required), kind (required), max_pages.
ca_search_tweetsSearch tweetsARead-only
Full-text search across the archive: every word must appear. Filter by author, by who was replied to, and by date. Pages with offset (max 5,000).
Inputs: q (required), limit, since, until, +4 more.
ca_threadThreadARead-only
Reconstruct the thread around a tweet: the reply chain above it, and the author's own continuation below it.
Inputs: ref (required), format, days_forward.
ca_tweets_windowEverything in a windowBRead-only
Every archived tweet created between since and until (window of at most 31 days), across all accounts. Cursor-paged.
Inputs: since (required), until (required), limit, cursor, +2 more.
ca_who_talks_aboutWho talks aboutBRead-only
Find people by topic: authors who tweet about a word or phrase, ranked by how often, with their earliest mention and best-received tweet.
Inputs: q (required), top, scan, since, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Most tools occupy clearly distinct slots: fetch-by-ID (ca_get_tweets), full-text search (ca_search_tweets), per-account timeline (ca_account_tweets), and global date window (ca_tweets_window) are well separated by their descriptions. The riskiest cluster is identity lookup — ca_account vs ca_members vs ca_find_people — where an agent must pick between exact profile, member roster, and fuzzy name search, but the descriptions do state the distinctions.
Every tool shares the ca_ namespace prefix and snake_case, which keeps the set readable as a unit. Verb style is mixed, though: some are verb_noun (ca_get_tweets, ca_search_tweets, ca_find_people), others are bare nouns (ca_account, ca_members, ca_receipt, ca_thread), and a few are phrasal (ca_first_said, ca_who_talks_about, ca_me).
At 15 tools the set sits at the top of the well-scoped range, and each tool maps to a distinguishable query pattern (ID lookup, search, timeline, aggregation, relation graph) rather than duplicating another. Nothing appears redundant or padded.
The surface covers the read-only archive domain thoroughly: profiles, tweet retrieval by ID, search, per-account and global timelines, relations, threads, provenance receipts, and analytic queries (first use, phrase trends, topic experts, follow-graph overlap). Minor gaps remain — no aggregate account statistics (tweet/media counts) and no media or URL-entity listing — but these are workarounds rather than dead ends for a read-only connector.
Maintenance
Related MCP Connectors
Hosted MCP server from TwitterAPI.io that gives AI agents read-only access to Twitter/X data. 12 tools: tweet search with X operators, user profiles, a user's latest tweets, followers and followings, replies, quotes, retweeters, mentions and trends. Connect at https://mcp.twitterapi.io/mcp with a TwitterAPI.io API key or account sign-in; usage is paid per result returned.
OAuth-enabled MCP server that extracts structured data from public social media posts.
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Official MCP server for twitterapis.com. Twitter/X search, users, DMs, Grok, monitoring and writes.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceRead-only MCP server for public X/Twitter search and retrieval via twitter.2-38.com-
- AlicenseAqualityBmaintenanceMCP server for the Twitter/X API, enabling search, user profiles, tweets, followers, and more via natural language.941,114 npm6MIT
- AlicenseAqualityBmaintenanceMCP server to read X (Twitter) posts, threads, replies, quotes, and search using your own logged-in session, no API key required.8206 PyPI4MIT
- AlicenseNot gradedqualityBmaintenanceEnables to search, draft, and profile from your X/Twitter archive locally via MCP tools.MIT