tweetfeed-mcp

Model Context Protocol (MCP) server for tweetfeed.live.

Exposes the public IOC feed (URLs, domains, IPs, SHA256/MD5 hashes shared by the infosec community on Twitter/X) as MCP tools so AI agents can query threat intel programmatically.

• Endpoint: https://mcp.tweetfeed.live/ (HTTP JSON-RPC 2.0, POST)
• Protocol version: 2025-11-25 (negotiated; older clients fall back automatically)
• Auth: none (all IOC data is CC0)
• License (data): CC0-1.0 · License (code): MIT

Tools

Name	Purpose
query_iocs	Query IOCs by time window (today/week/month) with optional user, tag, and type filters.
check_url	Check whether a specific URL appears in the feed.
check_ip	Check whether an IPv4/IPv6 address appears in the feed.
check_hash	Check whether an MD5 or SHA-256 hash appears in the feed (type auto-detected).
list_recent_iocs	List IOCs added since a given date, with optional type/tag filters.
get_tag_info	Window aggregates plus recent IOCs for a tag (leading # optional).
get_trending	Top tags and IOC-type distribution for a window (today/week/month/year).
enrich_ioc	Exact lookup of an IOC (auto-detected type: url/domain/ip/md5/sha256) over the past 365 days, with AI/external-corroboration/net/domain-registration (reg, including the domain's age in days at first report and a newly_registered flag) context and campaign membership when available, plus an archive of history older than 365 days when it exists (can accompany a live match); falls back to a 30-day substring scan on a miss.
get_campaigns	AI-clustered campaign groupings from the last 30 days, with optional brand and min-confidence filters.
get_campaign_iocs	Full IOC membership (header + rows) of one campaign by id, with optional type filter and limit.
get_trends	31-day IOC trend analytics: daily volume by type, top moving tags week-over-week, most-abused TLDs, new vs recurring ratio, producer concentration.
get_feed_status	Live pipeline health: freshness verdict per artifact (stale, age_seconds) and source coverage (which hashtag/account feeds delivered rows in the last 24h, which account feeds are dead).
search	ChatGPT connector interface: find document ids (ioc:<value>, tag:<tag>, campaign:<tfc-id>) for an IOC value, tag, campaign id or free text.
fetch	ChatGPT connector interface: full document ({id, title, text, url, metadata}) for an id returned by search.

Resources

Besides the 14 tools, the server exposes the feed as MCP resources (resources/list, resources/templates/list, resources/read): 7 static documents plus 2 URI templates, each returning the raw JSON of the matching api.tweetfeed.live document. Tools are the filtered, size-bounded path; resources are for clients that want a whole document (a status panel, a whole-window blocklist sync).

URI	Content
tweetfeed://status	Pipeline health plus per-source coverage (mirrors /v1/status, ~13 KB, refreshed every 15 min).
tweetfeed://counts	Aggregate IOC counts per window/type/tag (mirrors /v1/counts, ~3 KB).
tweetfeed://trends	31-day trend analytics (mirrors /v1/trends, ~4 KB, daily).
tweetfeed://campaigns	AI-clustered campaigns of the trailing 30 days (mirrors /v1/campaigns, ~300 KB, daily).
tweetfeed://iocs/today	Every IOC row shared today (mirrors /v1/today, 10-50 KB).
tweetfeed://iocs/week	Last 7 days (mirrors /v1/week, 100-300 KB).
tweetfeed://iocs/month	Last 30 days (mirrors /v1/month, 0.5-1 MB, API caps at 10,000 rows).
tweetfeed://iocs/{time}/{type}	Template - time: today|week|month, type: url|domain|ip|sha256|md5 (mirrors /v1/{time}/{type}).
tweetfeed://campaigns/{id}	Template - id = tfc- plus 12 hex chars (mirrors /v1/campaigns/{id}).

An unknown URI or an expired campaign id returns JSON-RPC error -32002 "Resource not found".

Prompts

Besides the 14 tools and the resources above, the server also speaks MCP prompts (prompts/list, prompts/get, params name and arguments as strings): ready-made recipes that chain several tool calls into one instruction sequence for the model to run and report back on. Where tools are chosen by the model and resources are raw documents, prompts are recipes the user invokes directly - they show up as slash commands in Claude Desktop and Claude Code.

Name	Arguments	Purpose
triage_ioc	ioc (required), context (optional)	Step-by-step triage of one IOC (URL/domain/IP/MD5/SHA-256): enrichment, campaign membership, verdict and recommended action.
daily_brief	window (optional, today default | week)	Short brief: feed health, volume and mix, moving tags, active high-confidence campaigns, abused TLDs.
campaign_summary	campaign_id (required, tfc- plus 12 hex)	Hand-off summary of one campaign: context, targeting, ATT&CK techniques, IOC breakdown, infrastructure, block-ready lists, CSV/STIX links.

Use with Claude Desktop / Claude.ai / other MCP clients

{
  "mcpServers": {
    "tweetfeed": {
      "url": "https://mcp.tweetfeed.live/"
    }
  }
}

Or from the Claude Code CLI:

claude mcp add tweetfeed https://mcp.tweetfeed.live/

Use as a ChatGPT connector

ChatGPT (Settings > Connectors > Create, or a Deep research custom connector) accepts https://mcp.tweetfeed.live/ with no authentication. The server exposes the required search and fetch tools alongside the others, and every result carries a tweetfeed.live URL so ChatGPT can cite it.

Quick test

curl -sX POST https://mcp.tweetfeed.live/ \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' | jq .

# Example tool call:
curl -sX POST https://mcp.tweetfeed.live/ \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":2,
       "params":{"name":"query_iocs",
                 "arguments":{"time":"today","tag":"phishing","type":"url","limit":5}}}' | jq .

# Example resource read:
curl -sX POST https://mcp.tweetfeed.live/ \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","method":"resources/read","id":3,
       "params":{"uri":"tweetfeed://status"}}' | jq .

# Example prompt call:
curl -sX POST https://mcp.tweetfeed.live/ \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","method":"prompts/get","id":4,
       "params":{"name":"triage_ioc","arguments":{"ioc":"example.com"}}}' | jq .

Develop

npm install
npm run dev          # wrangler dev on http://localhost:8787
MCP_URL=http://localhost:8787 npm test

Deploy

npm run deploy       # wrangler deploy (routes mcp.tweetfeed.live/*)
MCP_URL=https://mcp.tweetfeed.live npm test