# io.github.RipperMercs/terminalfeed (remote · terminalfeed.io)

Real-time data feeds for AI agents with USDC micropayments on Base for premium tools.

- Trust score: 59/100 (low)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `terminalfeed.io`: 59/100 (this document), [markdown](https://verifymcp.io/servers/rippermercs-terminalfeed/api-mcp.md), [page](https://verifymcp.io/servers/rippermercs-terminalfeed/api-mcp)

## Channel facts

- Endpoint: `https://terminalfeed.io/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 51/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 27 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS check failed: the endpoint is reachable over plaintext HTTP.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 67/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 3331 tokens (~123/item across 27 items; 27 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 20/100
  - Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http rippermercs-terminalfeed https://terminalfeed.io/api/mcp
```

### Codex

```toml
[mcp_servers.rippermercs-terminalfeed]
url = "https://terminalfeed.io/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rippermercs-terminalfeed": {
      "type": "remote",
      "url": "https://terminalfeed.io/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add rippermercs-terminalfeed --url https://terminalfeed.io/api/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  rippermercs-terminalfeed:
    url: "https://terminalfeed.io/api/mcp"
```

### Other

```json
{
  "mcpServers": {
    "rippermercs-terminalfeed": {
      "type": "http",
      "url": "https://terminalfeed.io/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 59, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 58, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 57, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 58, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 57, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 56, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 56)

First indexed and scored.

## MCP tools (27)

### `tf_briefing` (~73 tokens)

Fetches a real-time world-state snapshot composed from BTC ticker, Fear and Greed Index, recent earthquakes (USGS), top Hacker News story count, and ISS crew. Returns JSON. No auth required. Cache TTL 60s. Use when the agent needs a quick global pulse before deciding what to investigate.

### `tf_btc_price` (~64 tokens)

Fetches the current Bitcoin price in USD with 24h change, high, low, and volume. Source: Binance with CoinCap fallback. Cache TTL 15s. No auth required. Use for crypto trading decisions or when the agent needs a fresh BTC quote.

### `tf_fear_greed` (~66 tokens)

Fetches the current Crypto Fear and Greed Index value (0-100) with classification label (Extreme Fear, Fear, Neutral, Greed, Extreme Greed). Source: Alternative.me. Cache TTL 5min. Use as a sentiment signal for crypto trading decisions.

### `tf_crypto_movers` (~62 tokens)

Fetches the top 15 cryptocurrencies sorted by 24h price change. Includes price, market cap, and percentage move. Source: CoinGecko/CoinLore. Cache TTL 30s. Use when the agent needs to surface notable crypto market moves.

### `tf_predictions` (~59 tokens)

Fetches active Polymarket prediction markets sorted by 24h volume. Each market includes question, outcomes, and volume. Cache TTL 60s. Use when the agent needs market-implied probabilities on world events (elections, sports, macro).

### `tf_earthquakes` (~60 tokens)

Fetches recent earthquakes magnitude 2.5 or greater from USGS. Returns count and most recent quake details (magnitude, place, time). Cache TTL 2min. Use for disaster monitoring or when the agent needs current seismic activity.

### `tf_climate_earthquakes` (~184 tokens)

Fetches USGS pre-built summary feeds with selectable magnitude bucket (significant, 4.5, 2.5, 1.0, all) and period (hour, day, week, month). Returns flattened list (id, magnitude, place, time ISO 8601, depth_km, lat, lon, tsunami flag, USGS detail URL). Cache TTL scales with feed window (60s for hour, up to 900s for month). US Government public domain. Use when the agent needs more granular control than tf_earthquakes.

Input parameters:

- `magnitude` (string): Magnitude bucket: significant, 4.5, 2.5, 1.0, all. Default 2.5.
- `period` (string): Period bucket: hour, day, week, month. Default day.

### `tf_climate_weather_alerts` (~215 tokens)

Fetches active alerts from api.weather.gov filtered by area (2-letter state code), exact NWS event name, severity, urgency, and status. Returns id, event, severity, urgency, certainty, headline, description, areaDesc, sent/effective/expires/ends, sender_name, web URL. 60s cache. US Government public domain. US-only coverage. Use for situational awareness on active weather hazards.

Input parameters:

- `area` (string): 2-letter US state code, e.g. CA, NY. Optional.
- `event` (string): Exact NWS event name, e.g. "Tornado Warning", "Heat Advisory". Optional.
- `limit` (number): 1..100, default 50.
- `severity` (string): Extreme | Severe | Moderate | Minor | Unknown. Optional.
- `status` (string): Actual | Exercise | System | Test | Draft. Optional.
- `urgency` (string): Immediate | Expected | Future | Past | Unknown. Optional.

### `tf_service_status` (~69 tokens)

Fetches operational status of major dev infrastructure (GitHub, Cloudflare, Discord, OpenAI, Vercel, npm, Reddit, Atlassian, Anthropic). Cache TTL 60s. Use when the agent needs to know if a dependency is up or to explain a recent outage.

### `tf_economic_data` (~66 tokens)

Fetches latest FRED economic indicators: Fed funds rate, CPI, unemployment rate, GDP growth. Cache TTL 1h. Use when the agent needs current US macro indicators. For deeper macro (treasury yields, forex, commodities, indices) use tf_premium_macro.

### `tf_forex` (~87 tokens)

Fetches current foreign exchange rates with USD as base for 16 major currencies (EUR, GBP, JPY, CAD, AUD, CHF, CNY, INR, MXN, BRL, KRW, SGD, HKD, SEK, NOK, NZD). Source: Frankfurter (ECB-based). Cache TTL 5min. Use for currency conversion or FX-aware decisions.

### `tf_hf_trending` (~84 tokens)

Fetches the top 15 trending HuggingFace models sorted by likes in the last 7 days. Each item includes id (author/name), likes, downloads, pipeline tag, and url. Source: huggingface.co/api/models. Cache TTL 10min. Use when the agent needs to surface what the open-source AI community is paying attention to right now.

### `tf_harnesses` (~190 tokens)

Returns a snapshot of public agentic-coding benchmark scores across SWE-bench Verified, Terminal-Bench, Aider Polyglot, and METR HCAST. Each row pairs a harness with a model. Same model can score very differently on different harnesses; that gap is the value-add. Pass ?view=summary for top 10 combined leaderboard plus biggest harness gaps; ?view=gaps for full per-model harness deltas; ?view=combined for normalized cross-benchmark ranking; ?view=raw (default) for the full benchmark/result graph. Source: hand-curated from upstream leaderboards (swebench.com, terminal-bench.org, aider.chat, metr.org). Cache TTL 12h. Use when the agent needs to recommend a harness/model combo or explain why two agents using the same model perform differently.

Input parameters:

- `view` (string): Output shape; default raw

### `tf_solana_network` (~95 tokens)

Fetches live Solana mainnet network metrics: current transactions-per-second (most recent 60s sample), 3-sample average TPS, current slot, average slot time in ms, and epoch progress percentage. Source: solana-rpc.publicnode.com (getRecentPerformanceSamples + getSlot + getEpochInfo). Cache TTL 30s. Use when the agent needs to assess Solana network throughput or congestion.

### `tf_ai_stack_cves` (~132 tokens)

Current AI-software-stack CVE pulse: total advisories, exploited-in-the-wild count, severity and category breakdown, and the single top CVE headline, filtered to the AI stack (inference servers, agent frameworks, training libs, vector DBs, model gateways and SDKs, MCP tools). The full per-CVE list (affected version ranges, fixed versions, advisory source URLs) is premium on tensorfeed.ai at 1 credit; credits are cross-redeemable with terminalfeed.io. Source: GitHub Advisory Database plus vendor advisories, CC BY 4.0.

### `tf_premium_briefing` (~180 tokens)

Premium version of tf_briefing. Adds Polymarket prediction markets to the standard briefing payload and supports section filtering via ?include=. Covers earthquakes, Hacker News, humans in space, space launches, and prediction markets. Costs 1 credit ($0.02 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Use when the agent needs prediction-market context in addition to the basic snapshot. Strict premium, no free trial. Free basic version (without predictions) available at tf_briefing (no auth required). Note: crypto legs (BTC price, Fear and Greed) were removed 2026-07-23 for market-data licensing compliance.

Input parameters:

- `include` (string): Comma-separated subset of sections: earthquakes, hackernews, humans-in-space, launches, predictions. Omit for all sections.

### `tf_premium_macro` (~203 tokens)

Premium composed macroeconomic snapshot in one HTTP call. Includes FRED economic series (Fed rate, CPI, unemployment, GDP growth, 10-year treasury), 4 USD-base forex pairs (EUR, JPY, GBP, CHF) via Frankfurter, and oil/natural gas via FRED. All sources are public/gov (FRED, US government, public domain) or ECB reference rates (Frankfurter). Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Optional ?history=30d adds 30-day historical series. Note: US equity indices (SPY/DIA/QQQ), VIX, and gold were removed 2026-07-23 (Finnhub/Kraken are not licensed for commercial redistribution).

Input parameters:

- `history` (string): When set to 30d, FRED entries include a series array of 30 daily observations and forex.series is populated.

### `tf_premium_github_velocity` (~122 tokens)

Composed GitHub developer-attention snapshot. Returns top 30 repos created in the last 7 days sorted by stars (with stars-per-day, language, topics, license, owner type, AI/ML focus flag), top 15 AI/ML-focused active repos (topic:llm with commits in the last 30 days), language and topic aggregates, and the AI/ML share of trending. Source: GitHub Search API. Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required.

### `tf_premium_feed_reliability` (~164 tokens)

Premium reliability breakdown. For every monitored feed, a 0-100 composite reliability score with subscores (uptime, availability, staleness rate, dark rate), a sample-size trust tier, and a low_coverage flag, scored from rolling ok/stale/dark counts probed every 5 minutes. Ranked, with low-sample feeds parked separately. captured_at is the monitor real check time, so a stalled monitor (>48h) no-charges. The free preview is GET /api/feed-reliability (top-line table, no auth); this paid tier adds the signed receipt and the full per-feed breakdown. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>.

### `tf_premium_feed_reliability_history` (~152 tokens)

Premium reliability history. Returns the daily composite-reliability time-series for one feed (param feed, e.g. btc-price), with optional from/to date bounds (YYYY-MM-DD, query window capped at 365 days). Immutable past data; an empty range no-charges. Use the free GET /api/feed-reliability for current feed ids. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>.

Input parameters:

- `feed` (string): feed id, e.g. btc-price
- `from` (string): lower bound YYYY-MM-DD (optional)
- `to` (string): upper bound YYYY-MM-DD (optional)

### `tf_premium_correlation_matrix` (~161 tokens)

Pre-computed macro correlation matrix for AI trading and portfolio agents. Returns 30-day Pearson correlations on daily simple returns for 4 FRED series (US gov, public domain): 10Y treasury yield, 2Y treasury yield, trade-weighted USD index, and WTI crude oil. Output includes both a pairs array (sorted by absolute r descending) and an NxN matrix object for easy lookup. Each pair tagged with relationship strength (negligible / weak / moderate / strong) and direction (positive / negative). Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required. Note: crypto and equity legs were removed 2026-07-23 for market-data licensing compliance.

### `tf_premium_agent_context` (~209 tokens)

The "always start here" premium call for autonomous agents. Composes multiple public/gov upstream sources into a curated world-state snapshot: Fed funds rate, USD-base forex (EUR/JPY/GBP/CHF), HN front page top 5, significant earthquakes 24h, upcoming space launches, top Polymarket markets, and infrastructure status (GitHub, Cloudflare, OpenAI, Anthropic). Returns BOTH a structured JSON `context` object for parsers AND a pre-formatted `system_prompt` string the agent pastes verbatim into its LLM context. Saves the agent from making many separate calls and writing a formatter. Curation choice (which signals matter, how to compress them) is the moat. Costs 2 credits ($0.04 USDC). 5-min cache. Bearer auth required. Note: crypto (BTC, Fear and Greed) and VIX legs were removed 2026-07-23 for market-data licensing compliance.

### `tf_premium_world_deltas` (~188 tokens)

Premium event-stream endpoint for monitor agents. Aggregates time-stamped events from 4 sources into one time-sorted feed: USGS earthquakes M4.0+, Hacker News new stories via Algolia, recently updated Polymarket markets, and space launches in [-1h, +12h] window. Accepts ?since=<ISO timestamp> (defaults 1h ago, clamped to 1h cache horizon). Each event has type, timestamp, severity, and structured data. Saves an agent from polling 5 separate upstream feeds and merging client-side. Costs 2 credits ($0.04 USDC). Bearer auth required. 1-hour rolling cache; sub-second when warm.

Input parameters:

- `since` (string): ISO 8601 timestamp. Returns events newer than this. Defaults to 1 hour ago. Clamped to 1 hour ago if older.

### `tf_payment_buy_credits` (~119 tokens)

POST endpoint that returns the published USDC wallet address (0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1 on Base mainnet), a unique memo, and a quote tying the dollar amount to credits at $1 USDC = 50 credits. Use as the first step when the agent needs to buy credits to access /api/pro/* endpoints.

Input parameters:

- `amount_usd` (number): USDC amount to convert. Minimum $1 = 50 credits.

### `tf_payment_confirm` (~119 tokens)

POST endpoint that verifies an on-chain Base mainnet USDC transfer to the published wallet and returns a bearer token (tf_live_<64-char-hex>) plus credit count. Use after the agent has sent USDC, with the tx hash and the memo from tf_payment_buy_credits. The returned token is cross-redeemable on tensorfeed.ai.

Input parameters:

- `nonce` (string): The memo string returned from tf_payment_buy_credits (optional but recommended).
- `tx_hash` (string): On-chain Base mainnet USDC transaction hash.

### `tf_payment_balance` (~48 tokens)

GET endpoint that returns remaining credits for the bearer token in the Authorization header. Requires Authorization: Bearer tf_live_<64-char-hex>. Costs 0 credits. Use to monitor agent budget.

### `tf_payment_history` (~76 tokens)

GET endpoint that returns confirmed USDC purchases (tx_hash, amount_usd, credits_added, block_number, confirmed_at) plus current balance and totals for the bearer token. Requires Authorization: Bearer tf_live_<64-char-hex>. Costs 0 credits. Tokens minted before the ledger existed return current_balance with purchases: [].

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/rippermercs-terminalfeed/api-mcp#diagnostics

## Score history

- 2026-08-03: 59
- 2026-08-02: 58
- 2026-08-01: 58
- 2026-07-31: 57
- 2026-07-30: 58
- 2026-07-29: 58
- 2026-07-28: 57
- 2026-07-27: 56
- 2026-07-26: 56

## Links

- Remote endpoint: https://terminalfeed.io/api/mcp
- Repository: https://github.com/RipperMercs/terminalfeed
- Website: https://terminalfeed.io/developers
- Changelog RSS feed: https://verifymcp.io/servers/rippermercs-terminalfeed/api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/rippermercs-terminalfeed/api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/rippermercs-terminalfeed/api-mcp