English Français العربية

TweetFeed

السجل الرسمي التسويق والمبيعات

IOCs (URLs, domains, IPs, hashes) shared by the infosec community on X/Twitter. No auth, CC0.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http tweetfeed 'https://mcp.tweetfeed.live/'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "tweetfeed": {
            "type": "http",
            "url": "https://mcp.tweetfeed.live/"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. tweetfeed-mcp
  2. Tools
  3. Resources
  4. Prompts
  5. Use with Claude Desktop / Claude.ai / other MCP clients
  6. Use as a ChatGPT connector
  7. Quick test
  8. Develop
  9. Deploy

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

NamePurpose
query_iocsQuery IOCs by time window (today/week/month) with optional user, tag, and type filters.
check_urlCheck whether a specific URL appears in the feed.
check_ipCheck whether an IPv4/IPv6 address appears in the feed.
check_hashCheck whether an MD5 or SHA-256 hash appears in the feed (type auto-detected).
list_recent_iocsList IOCs added since a given date, with optional type/tag filters.
get_tag_infoWindow aggregates plus recent IOCs for a tag (leading # optional).
get_trendingTop tags and IOC-type distribution for a window (today/week/month/year).
enrich_iocExact 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_campaignsAI-clustered campaign groupings from the last 30 days, with optional brand and min-confidence filters.
get_campaign_iocsFull IOC membership (header + rows) of one campaign by id, with optional type filter and limit.
get_trends31-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_statusLive 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).
searchChatGPT connector interface: find document ids (ioc:<value>, tag:<tag>, campaign:<tfc-id>) for an IOC value, tag, campaign id or free text.
fetchChatGPT 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).

URIContent
tweetfeed://statusPipeline health plus per-source coverage (mirrors /v1/status, ~13 KB, refreshed every 15 min).
tweetfeed://countsAggregate IOC counts per window/type/tag (mirrors /v1/counts, ~3 KB).
tweetfeed://trends31-day trend analytics (mirrors /v1/trends, ~4 KB, daily).
tweetfeed://campaignsAI-clustered campaigns of the trailing 30 days (mirrors /v1/campaigns, ~300 KB, daily).
tweetfeed://iocs/todayEvery IOC row shared today (mirrors /v1/today, 10-50 KB).
tweetfeed://iocs/weekLast 7 days (mirrors /v1/week, 100-300 KB).
tweetfeed://iocs/monthLast 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.

NameArgumentsPurpose
triage_iocioc (required), context (optional)Step-by-step triage of one IOC (URL/domain/IP/MD5/SHA-256): enrichment, campaign membership, verdict and recommended action.
daily_briefwindow (optional, today default \week)Short brief: feed health, volume and mix, moving tags, active high-confidence campaigns, abused TLDs.
campaign_summarycampaign_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

الأسئلة الشائعة

ما هو TweetFeed؟

IOCs (URLs, domains, IPs, hashes) shared by the infosec community on X/Twitter. No auth, CC0.

كيف أثبّت TweetFeed؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http tweetfeed 'https://mcp.tweetfeed.live/'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج TweetFeed إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل TweetFeed مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون TweetFeed؟

ينشره 0xDanielLopez. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.