All MCP Servers
Finance & DataMCP Registrynpm7 toolsA · 86

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.

Source 8GitHub stars

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

  1. Add the server

    bash
    claude mcp add prereason -e 'PREREASON_API_KEY=<PREREASON_API_KEY>' -- npx -y @prereason/mcp
  2. Fill in your credentials

    Replace <PREREASON_API_KEY>, <X-API-KEY> with your real values. Keep secrets out of any config file you commit.

  3. Verify it's connected

    bash
    claude mcp list
  4. Sharing 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).

  5. 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.

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 variable

    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_CLIENToptionalEnvironment variable

    The app this bridge runs in (claude-desktop, cursor, windsurf, claude-code, ...), so your PreReason dashboard names the connection.

  • X-API-KeyoptionalsecretHTTP header

    PreReason 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.

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

Claude Code: NativeClaude Desktop: NativeCursor: NativeCodex CLI: NativeWindsurf: NativeCline: NativeVS Code: Native

Health score

A · 86

Maintenance, 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:

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

Excerpt — the full document is on GitHub.

Maintain PreReason? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown
[![PreReason on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/com-prereason-mcp)](https://mcp-skills-hub.vercel.app/mcps/com-prereason-mcp)

Catalog data refreshed . Something wrong? Report it.