Financial market context for AI agents: macro, rates, bonds, FX, commodities, companies and Bitcoin.

Docs · Briefings · Company briefings · Pricing · Get a key

Ask your AI where Treasury yields are. On its own, it reaches for a search result or a raw series and works out the rest by itself. When it prereasons, one get_context call brings back the context already worked out: the 30 year yield at 5.67% on 2026-10-07, the highest reading on the US Treasury's daily par yield curve since July 2001.

The analysis, and the data behind it. Each briefing arrives with the reading done: the trend over several windows, where a value sits in its own history, a company's rank among its peers and, where read, its own guidance.

Every figure dated, every source named. Your agent can say when a number is from and where it came from.

One call, a whole briefing. A briefing gathers the series a question needs, so the turns go to the answer rather than to lookups.

The markets in one place. Rates and Treasuries, the Fed, FX, commodities, macro, listed companies in the USA, Japan, Korea and India, and Bitcoin.

It describes; it never advises. Briefings say what the data shows. They never say what to buy, sell or hold.

Quick to set up. One block of config for Claude, Cursor, Codex or VS Code, through the npm bridge or the remote server. The catalogue tools need no key; for the rest, the bridge gives you one link to approve in your browser and the key arrives in the running session, and the remote server asks you to sign in.

What it covers

PreReason gives an AI agent market context it can reason with. One call returns a briefing with the analysis already in it: a one line reading, trend direction over several windows, confidence scores, percentile ranks and correlations, and in the deeper briefings a regime label and a plain language narrative. The briefings cover macro, bonds, FX, commodities, Bitcoin, Ethereum and cross asset correlations. Company briefings cover listed companies in the USA, Japan, Korea, India, the UK, France, Austria, Belgium, Denmark, Finland, Iceland, Italy, Lithuania, the Netherlands, Slovenia and Slovakia, one company per call. The catalogue holds 33 live briefings and 293 individual metrics, among them Treasury yields, the latest FOMC statement, the macro release calendar, Treasury auctions, who holds US Treasuries, the Fed balance sheet, M2, net liquidity, the dollar, US crude and gas inventories, gold, silver, copper and wheat, oil, mining and agribusiness companies beside their commodity, AI compute and power demand, Bitcoin price and momentum, Bitcoin network and miner health, spot Bitcoin ETF flows and corporate Bitcoin treasuries. It is served over MCP (a remote server and an npm bridge) and over REST, as Markdown or JSON. Over MCP, the catalogue tools need no account, and a briefing needs a PreReason account, signed in through the connector or with an API key; a free account reads the free briefings. Over REST, a briefing takes an API key or, on the routes that take one, an x402 payment per call with no account.

Option 1: Claude Desktop, no key needed

Requires Node.js 18+, and nothing else: the bridge has no dependencies.

Add this to claude_desktop_config.json and restart Claude Desktop:

{ "mcpServers": { "prereason": { "command": "npx", "args": ["-y", "@prereason/mcp"], "env": { "PREREASON_CLIENT": "claude-desktop" } } } }

The catalogue tools work at once. To connect your account, tell Claude "connect me to PreReason", or ask for any briefing: either way Claude shows one link, https://www.prereason.com/claim/PR-XXXX-XXXX. Open it, sign in or create a free account, click Approve. The key arrives in the bridge on its own, is saved to ~/.prereason/credentials.json, and is never shown; ask Claude whether PreReason is connected and it names your plan. Nothing is created in your account until you click Approve, and the link is asked for when you need it, so it never runs out while Claude sits open. If your account already holds as many API keys as it allows, the answer says so instead of looping: revoke a key under Settings on prereason.com, then ask to connect again, or set PREREASON_API_KEY to a key you already have.

Already have a key? Add it to the env block as "PREREASON_API_KEY": "pr_live_..." and the bridge never asks.

Clients that hold their own config can call the endpoint directly, with the key as a header:

Claude Code

claude mcp add --transport http prereason https://api.prereason.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

{ "mcpServers": { "prereason": { "type": "http", "url": "https://api.prereason.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

Windsurf uses serverUrl instead of url; Gemini CLI uses httpUrl; Codex uses url plus bearer_token_env_var in config.toml. No key yet? Point the client at the endpoint without a header to browse the catalogue, then create a key on the website (below) and add the header.

Add PreReason as a custom connector, choose "No sign-in", and where the Request headers section is available add Authorization with the value Bearer YOUR_API_KEY (the word Bearer and the space are part of the value). Sign in support for connectors is being re-tested and is not offered until it is verified.

Three ways, all free. The hosted server never hands out a key inside a session and never asks for one.

Through this bridge. Run it with no key set: when you ask your assistant to connect PreReason, or an answer needs a key, it asks PreReason for access on your behalf and shows one approve_url, in its log and in the answer. Open it, sign in or create your account, click Approve, and the bridge saves the key, attached to your account and named Agent: <client_name>.

From code, for an agent with no browser. POST https://api.prereason.com/api/agent/claims (no auth), show the human the approve_url, then poll GET https://api.prereason.com/api/agent/claims/{claim_code} with Authorization: Bearer <claim_token> until status is approved. Docs: prereason.com/docs#agent-access.

Tool Auth Description

list_briefings Open List all 33 pre-reasoned market briefings with tier requirements; with search, only those that match a question, and the covered companies it names, each with the entity to pass

list_metrics Open List every available metric across the bitcoin, macro, calculated and eth categories

get_health Open API health check, version, account tier

get_context Required Fetch a pre-reasoned market briefing (markdown or JSON); for a company briefing, entity names the company and block reads one of its 11 parts (see Company Briefings)

get_metric Required Fetch a single metric with trend/signal/percentile

get_changes Required (Basic and above) What changed since your last call: change events after a cursor, no values

get_news Required Dated records of what companies filed and what federal agencies and the Federal Reserve published, newest first, each with its source, its date or time and a link; it states records, not reasons

The npm bridge and the Claude Desktop extension add one tool of their own, connect_account, which the bridge answers itself and the remote server does not offer: with no key yet it returns the one link to approve, and once approved it says the account is connected and on which plan. It never shows a key and never asks for one.

Free (6 briefings)

Briefing Description

btc.quick-check Minimal fast context: BTC + Net Liquidity + correlation

btc.context BTC + liquidity + hash ribbon + difficulty + momentum

macro.snapshot Fed balance, M2, treasury yields, dollar strength, net liquidity

cross.correlations BTC correlation matrix vs macro indicators

btc.pulse Price, 24h change, Bitcoin dominance

btc.grid-stress Epoch pace and difficulty adjustment forecast

Basic - $19.99/mo (14 briefings)

Briefing Description

btc.momentum 200D MA support/resistance with 7d/30d/90d momentum and percentile rankings

macro.liquidity Liquidity indicators with momentum analysis

btc.on-chain Hash rate, difficulty, transactions, active addresses

cross.breadth Breadth across SPY, QQQ and IWM, with Bitcoin's correlation to each

btc.miner-survival Hashprice thermometer with miner stress scoring

btc.etf-flows Spot BTC ETF net daily flows, aggregate AUM, and per-issuer breakdown

macro.auctions Treasury auction demand: who bought at the latest auction of each note and bond maturity, against that maturity's own prior 12 auctions, with the auctions announced and scheduled next

bonds.context Who holds US Treasuries, in short: foreign investors' net purchases (Treasury's TIC), primary dealers' 13 week change in positions (the New York Fed) and speculators' 10 year note futures position (the CFTC), each against its own history, with the 10 year yield and three bond funds

eth.context Where Ether stands: its price and global 24 hour volume from CoinGecko, its distance from the 200 day average, Lido's stETH APR, the CFTC's CME Ether positioning and OKX's funding rate

commodities.gold The gold fund (GLD) and gold's own monthly price from the World Bank, with the 10 year real rate, the dollar fund, the CFTC's COMEX gold positioning and the miners' fund, each with its measured relationship to GLD

commodities.silver The silver fund (SLV) and silver's own monthly price from the World Bank, with the CFTC's COMEX silver positioning and the gold, dollar, copper and silver miners' funds and the 10 year real rate, each with its measured relationship to SLV

commodities.copper A copper futures fund (CPER) and copper's own monthly price from the World Bank, with the CFTC's COMEX copper positioning and the dollar and gold funds, each with its measured relationship to CPER

commodities.wheat A wheat futures fund (WEAT) and US soft red winter wheat's own monthly price from the World Bank, with the CFTC's CBOT wheat positioning, the dollar fund and the WTI spot price, each with its measured relationship to WEAT

macro.calendar The scheduled dates ahead of the main US releases, the FOMC and ECB decisions, the FOMC minutes and the Treasury coupon auctions ahead (the week's, or the next one), each from its publisher's own calendar, with the latest US jobs report, CPI and weekly jobless claims as published and what each release revised

Pro - $49.99/mo (13 briefings)

Briefing Description

btc.full Full Bitcoin analysis: macro overlay, momentum, percentiles, correlations and narrative

btc.factors Multi-factor attribution for BTC price movements

cross.regime Regime classification (expansion, contraction, transition) with USDT dominance

fx.liquidity EUR/USD, USD/CNY and dollar strength, with net liquidity and Bitcoin correlations

btc.energy Production cost model with gas input pressure

btc.treasury Corporate Bitcoin treasury intelligence from SEC filings

macro.rates Treasury par yield curve at every maturity, 1M to 30Y, breakeven inflation, 5y5y forward, Germany 10Y

cross.ai-compute AI compute and power chain: US grid demand against a year earlier, miners' AI hosting agreements from SEC filings, hosting against mining per megawatt

commodities.energy-basket US oil and gas stocks against the five year norm from EIA's weekly reports, with WTI, Brent and Henry Hub spot prices, the Brent to WTI spread and WTI realised volatility

bonds.full Who holds US Treasuries: foreign investors, primary dealers and speculators, each against its own history, with the Fed's own Treasury holdings, debt held by the public, the largest foreign holders, what would change each reading and the next reports

commodities.oil-producers Crude oil beside its covered USA producers: the energy basket's state, WTI and Brent spot prices from EIA, then each integrated major, producer and refiner and two oil field service companies, with its share price, its 1, 3 and 12 month changes beside WTI and the measured 90 day correlation with WTI

commodities.gold-miners The gold fund (GLD, a share price, not the gold price) and gold's ow