BTC Intel

npx add-mcp 'https://btcintel.org/mcp'

BTC Intel for AI agents

Understand where Bitcoin is today, compared with its own history.

BTC Intel is an independent Bitcoin market intelligence source: a daily 0 to 100 market assessment, where today ranks in the full record, its momentum and statistics, and a daily intelligence brief. Free, with no account or key: Bitcoin today (the price, the market read and its five areas, the forces behind them and the calendar ahead), any area in depth, past days' reads, and the Score's full record since 2011 up to three months ago. Agents with a Lightning wallet can get the live Score, paid per call in bitcoin.

Use BTC Intel in Claude or ChatGPT. Free, read-only, no sign-in: add https://btcintel.org/mcp/free as a custom connector. In Claude: Customize, Connectors, Add custom connector, then paste the address. In ChatGPT: turn on developer mode in its settings, then add a connector with the same address. Perplexity, Mistral Le Chat and others: see Set up your AI client below. The free address has the market read and its five areas, the Brief, the Score's free record and the Intel DCA rules; the address below adds the paid live data.

The record. One reading a day since July 18, 2011. Days before live publication are backtested with the current method, and every row says which it is (live or backtested). Past readings are never rewritten: the record is append-only and hash-chained.

Historical position. For any day, the share of recorded days above and below that day's reading (days equal to it count in neither). The historical position describes where today's Score sits in the record, not what comes next.

Free and paid.

Access	Covers	Price
Free	Today's market read, current: the price and its moves, the five areas and their components, what changed and the calendar ahead. Plus the methodology, the Intel DCA rules, and the Score's record since 2011, up to three months ago.	Free
Live	The same tools on data through the latest published day	$0.25 a call
Live export	The full record through the latest day, CSV or JSON, every page	$1.00 an export

Each paid call is paid on its own: no subscription, nothing recurring. The price and what it covers are shown before you pay. One payment opens every page of the same query for 24 hours.

Connect over MCP.

https://btcintel.org/mcp (Streamable HTTP, no sign-in).

Tool	What it returns
get_bitcoin_today	Free. Bitcoin today: the price and its moves, the market read and the five areas, the forces behind it with their figures, what changed and the calendar.
get_calendar	Free. The events ahead, each with why it matters.
get_area	Free. One area in depth: its read by horizon, the reasoning and its parts.
get_score_for_day	The Score, its level and historical position in the record.
get_score_momentum	Change over 1, 7, 30 and 90 days, and the level at each point
get_score_statistics	Mean, median, spread, lows and highs with dates, the distribution, time in each level, for the whole record or a date range
get_score_history	Daily Score, level, historical position in the record and change.
get_classification_history	Every stretch in a level and every move between levels
get_read_for_day	A past day's read: the Full Read and the five area words for that day.
get_methodology	What the Score is, its scale and level boundaries, the record's dates, how it updates, definitions and limits
get_market_detail	Free. The published market read in detail: each of the five areas with its state, its position on the five-step scale, its explanation and last change, and its components as the Analysis pages show them, each with its state and position. The market components describe the published market read. The BTC Intel Score is computed separately.
get_score_live	Today's live Score, level and historical position (kept for existing clients)
get_plan_rules	The Intel DCA plan rules, free

Resources (read-only, same free and live rule): btcintel://score/latest, btcintel://score/history, btcintel://score/methodology, btcintel://score/classifications, btcintel://market-forces, btcintel://statistics/current, btcintel://intelligence/daily, btcintel://market-detail.

Set up your AI client.

No key and no account: add the server address to your client. Only Claude Code has been tested by us; the others are each client's documented format, marked untested until a connection test succeeds.

Claude Code · Tested: connects

claude mcp add --transport http btc-intel https://btcintel.org/mcp

Cursor · Untested

// ~/.cursor/mcp.json
{ "mcpServers": { "btc-intel": { "url": "https://btcintel.org/mcp" } } }

VS Code · Untested

// .vscode/mcp.json
{ "servers": { "btc-intel": { "type": "http", "url": "https://btcintel.org/mcp" } } }

Claude (web and desktop) · Untested

Customize, Connectors, Add custom connector, URL https://btcintel.org/mcp/free (the free tools; every plan, the Free plan one custom connector)

ChatGPT · Untested

Settings, turn on developer mode, then add a connector with the URL https://btcintel.org/mcp/free (the free tools)

Perplexity · Untested

Settings, Connectors, + Custom connector, Remote, URL https://btcintel.org/mcp/free (on plans that offer custom connectors)

Mistral Le Chat · Untested

Connectors, + Add Connector, Custom MCP Connector, a name and the URL https://btcintel.org/mcp/free

Gemini CLI · Untested

// ~/.gemini/settings.json
{ "mcpServers": { "btc-intel": { "httpUrl": "https://btcintel.org/mcp" } } }

Windsurf · Untested

// ~/.codeium/windsurf/mcp_config.json
{ "mcpServers": { "btc-intel": { "serverUrl": "https://btcintel.org/mcp" } } }

Your first free call.

Ask your assistant, for example: "What is the BTC Intel Score on the latest free day?" It calls get_score_for_day, and the server answers:

The BTC Intel Score on 2026-08-06 was 28 (Moderate-low); a backtested day. Free answers stop at the Delayed date, 2026-08-06; later days are paid (live = true).

Example answer from November 6, 2026; the date moves forward every day.

Plain HTTP.

The same answers without MCP: send a GET to a route below. Each returns what the matching tool returns, with the same free and live rule; for live data add live=true and pay with Authorization: L402 <macaroon>:<preimage>.

Route	Same as
/api/agent/score	get_score_live (paid)
/api/agent/score/latest	get_score_for_day
/api/agent/score/momentum	get_score_momentum
/api/agent/score/statistics	get_score_statistics
/api/agent/score/history	get_score_history
/api/agent/score/classifications	get_classification_history
/api/agent/score/methodology	get_methodology
/api/agent/intelligence/daily	get_read_for_day
/api/agent/market-forces	btcintel://market-forces
/openapi.json	The OpenAPI description of every route

How paying works (L402).

Call a live tool without payment: you get a Lightning invoice and a macaroon. Pay the invoice with any Lightning wallet, then call again with payment = <macaroon>:<preimage> (over HTTP: Authorization: L402 <macaroon>:<preimage>).

1. Ask for live data. Call a paid tool with live set (or get_score_live). Nothing is charged: the answer is the price in dollars and sats, a Lightning invoice and a macaroon (a token naming that invoice).
2. Pay the invoice. Pay it from a Lightning wallet within 10 minutes. The amount in sats follows the bitcoin price at that moment; the dollar price stays $0.25.
3. Find the preimage. A paid invoice gives your wallet a preimage: 64 characters, 0-9 and a-f, the proof that you paid. Open the payment's details in the wallet. Not every wallet shows it.
4. Return the proof. Give the preimage to your AI client and ask it to call the same tool again with the same arguments and payment = <macaroon>:<preimage>. The answer follows; one payment buys one answer of that call.
5. If it expires. An unpaid invoice expires after 10 minutes and nothing is charged: call again for a new one. Once paid, use the proof within 24 hours.

Wallets that show the preimage. These released versions show it in a payment's details, according to each wallet's own published code (checked November 7, 2026): Zeus 13.2.4 ("Payment Preimage"), Phoenix for Android 2.8.4 ("Preimage") and Blixt 0.9.0 ("Preimage", in the transaction details). BTC Intel has not tested a payment with any of them. Wallets change: if yours does not show the preimage, the payment cannot be proven here.

curl -i https://btcintel.org/api/agent/score
# 402 Payment Required, with a Lightning invoice and a macaroon
curl -H "Authorization: L402 <macaroon>:<preimage>" https://btcintel.org/api/agent/score

Example: what a paid call looks like.

Both answers below are real answers from the server, November 6, 2026; the invoice and token are shortened.

The paywall, asking get_score_for_day for live data:

Payment required: $0.25 (330 sats) for get_score_for_day, 2026-11-06, 1 page. One payment covers one answer of this call; no recurring charge. Pay the Lightning invoice, then call again with the same arguments and payment = "<macaroon>:<preimage>".
invoice: lnbc…
macaroon: …

What $0.25 buys: the same answer as the free one, for the latest published day instead of a day three months back. The free answer's fields, as the server returns them:

{
  "date": "2026-08-06", "score": 28, "score_exact": 28.3, "level": "Moderate-low",
  "live": false, "basis": "backtested", "as_of": "2026-08-06", "access": "free",
  "source": "BTC Intel", "link": "https://btcintel.org/score", "note": "Research, not investment advice."
}

A paid answer gives the same kind of answer for the latest published day. No live value is shown on this page.

Every answer carries an as_of time in UTC, live or backtested per row, the source (BTC Intel, btcintel.org) and a research note.

Limits. Free tools: per-caller rate limits. Paid: 20 invoices an hour per caller.

What the Score is not. Research, not investment advice: not a trading signal, no forecast, no claim that it beats any strategy. Its inputs, weights and method are not published.

Cite as BTC Intel, btcintel.org. More: OpenAPI · llms.txt · Methodology