PreReason MCP server
com.prereason · Updated
Financial market context for AI agents, with listed companies' results: www.prereason.com/agents.md
At a glance
PreReason is an MCP server in the Finance & Data category. It runs locally over stdio via `npx -y @prereason/mcp`, and needs PREREASON_API_KEY and X-API-Key. It exposes 7 tools, including list_briefings, list_metrics and get_health. It scores A (86/100) on the MCP Skills Hub health score as of Oct 27, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install PreReason in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install PreReason in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add prereason -e 'PREREASON_API_KEY=<PREREASON_API_KEY>' -- npx -y @prereason/mcpFill in your credentials
Replace <PREREASON_API_KEY>, <X-API-KEY> with your real values. Keep secrets out of any config file you commit.
Verify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. list_briefings, list_metrics, get_health). It discovers them automatically.
How to install PreReason in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "prereason": { "command": "npx", "args": [ "-y", "@prereason/mcp" ], "env": { "PREREASON_API_KEY": "<PREREASON_API_KEY>" } } } }Fill in your credentials
Replace <PREREASON_API_KEY>, <X-API-KEY> with your real values. Keep secrets out of any config file you commit.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install PreReason in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "prereason": { "command": "npx", "args": [ "-y", "@prereason/mcp" ], "env": { "PREREASON_API_KEY": "<PREREASON_API_KEY>" } } } }Fill in your credentials
Replace <PREREASON_API_KEY>, <X-API-KEY> with your real values. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install PreReason in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.prereason] command = "npx" args = ["-y", "@prereason/mcp"] env = { PREREASON_API_KEY = "<PREREASON_API_KEY>" }Fill in your credentials
Replace <PREREASON_API_KEY>, <X-API-KEY> with your real values. Keep secrets out of any config file you commit.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install PreReason in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "prereason": { "command": "npx", "args": [ "-y", "@prereason/mcp" ], "env": { "PREREASON_API_KEY": "<PREREASON_API_KEY>" } } } }Fill in your credentials
Replace <PREREASON_API_KEY>, <X-API-KEY> with your real values. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install PreReason in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "prereason": { "command": "npx", "args": [ "-y", "@prereason/mcp" ], "env": { "PREREASON_API_KEY": "<PREREASON_API_KEY>" } } } }Fill in your credentials
Replace <PREREASON_API_KEY>, <X-API-KEY> with your real values. Keep secrets out of any config file you commit.
How to install PreReason in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "prereason": { "type": "stdio", "command": "npx", "args": [ "-y", "@prereason/mcp" ], "env": { "PREREASON_API_KEY": "<PREREASON_API_KEY>" } } } }Fill in your credentials
Replace <PREREASON_API_KEY>, <X-API-KEY> with your real values. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What does PreReason need from you?
API key — PreReason API key (starts with pr_live_). Optional: without it the bridge asks for access from inside the session and prints one link for you to approve; the key is then saved under ~/.prereason. Or sign up at prereason.com.
PREREASON_API_KEYoptionalsecretEnvironment variablePreReason API key (starts with pr_live_). Optional: without it the bridge asks for access from inside the session and prints one link for you to approve; the key is then saved under ~/.prereason. Or sign up at prereason.com.
PREREASON_CLIENToptionalEnvironment variableThe app this bridge runs in (claude-desktop, cursor, windsurf, claude-code, ...), so your PreReason dashboard names the connection.
X-API-KeyoptionalsecretHTTP headerPreReason API key, pasted as is with no prefix. Optional: without it the catalogue tools work.
Pass secrets through your shell environment rather than committing them into a config file.
What tools does PreReason expose? (7)
Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.
- list_briefingsOpen
- list_metricsOpen
- get_healthOpen
- get_contextRequired
- get_metricRequired
- get_changesRequired (Basic and above)
- get_newsRequired
What the code can do
Read from the published package source — never executed. Parsed 8 of 8 source files.
This server can read and write files, read your environment variables and read system information.
How it was published
- Published by a verified CI identity (github trusted publishing) rather than a personal token.
- Has a provenance attestation tying this artifact to the commit it was built from.
- 1 npm maintainer — a single point of compromise · last published by GitHub Actions.
Maintainer of this package and think something here is wrong? Tell us and we'll correct it.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
- Downloads at launch — The package is fetched from its registry each run unless you pin a version.
- Last commit 10 days ago — Actively maintained.
- 8 GitHub stars — Very little community usage so far.
Client compatibility
Health score
A · 86Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%100%
Last commit 10 days ago.
- Adoption20%29%
8 stars.
- Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
- Provenance15%100%
Package and registry entry point at the same repository.
- Packaging15%100%
Publishes a pinned version (0.9.1).
Documentation
Full README@prereason/mcp
[Prereason](https://www.prereason.com) first. Then answer.
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.
Why prereason?
- 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; the remote server takes your API key as a header.
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.
Quick Start
Option 1: Claude Desktop, no key needed
Requires [Node.js 18+](https://nodejs.org), 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" }
}
}
}Excerpt — the full document is on GitHub.
Alternatives to PreReason
- Apiary MemoryB · 76Local-first memory over MCP. Built-in SQLite store; runs standalone. Agents propose; you confirm.
- Memory HiveA · 83Local-first memory over MCP. Built-in SQLite store; runs standalone. Agents propose; you confirm.
- Vibe Test — Browser Testing AgentA · 88Code-aware browser testing agent — 14 Playwright tools for AI code editors via MCP
- Tapetide - Indian Stock Market MCPA · 9348 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
Maintain PreReason? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/com-prereason-mcp)Catalog data refreshed . Something wrong? Report it.