# PreReason

PreReason gives AI agents market context across rates, bonds, FX, commodities, companies and Bitcoin. Use it when answers need dated figures and sources.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: PreReason
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PreReason/mcp
- Updated: 2026-10-18
- HTML: https://affpapa.org/en/nevibecode/mcp/prereason

## What it does

PreReason connects an agent to financial briefings through MCP. A `get_context` call returns prepared market context, including trend direction, changes across several periods, historical positioning, dates and sources. Coverage includes macro data, bonds, currencies, commodities, Bitcoin, Ethereum and listed companies.

The server can provide material on Fed decisions, Treasury yields, inflation expectations, commodity inventories and other metrics. It describes what the data shows rather than recommending trades. The local bridge requires Node.js 18+, while briefings require a PreReason account or an API key.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.prereason.com/api/mcp`
- Environment variables: `PREREASON_API_KEY`, `PREREASON_CLIENT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.prereason.com/api/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env PREREASON_API_KEY=<PREREASON_API_KEY> --env PREREASON_CLIENT=<PREREASON_CLIENT> --transport stdio prereason -- npx -y @prereason/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add prereason --url https://api.prereason.com/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add prereason --env PREREASON_API_KEY=<PREREASON_API_KEY> --env PREREASON_CLIENT=<PREREASON_CLIENT> -- npx -y @prereason/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "prereason": {
            "url": "https://api.prereason.com/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "prereason": {
            "command": "npx",
            "args": [
                "-y",
                "@prereason/mcp"
            ],
            "env": {
                "PREREASON_API_KEY": "<PREREASON_API_KEY>",
                "PREREASON_CLIENT": "<PREREASON_CLIENT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "prereason": {
            "type": "http",
            "url": "https://api.prereason.com/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "prereason": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@prereason/mcp"
            ],
            "env": {
                "PREREASON_API_KEY": "<PREREASON_API_KEY>",
                "PREREASON_CLIENT": "<PREREASON_CLIENT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http prereason https://api.prereason.com/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e PREREASON_API_KEY=<PREREASON_API_KEY> -e PREREASON_CLIENT=<PREREASON_CLIENT> prereason npx -y @prereason/mcp
```
Replace <…> with your own values

## When to use it
- retrieve context on rates and bonds
- compare a metric with its own history
- inspect a currency or commodity trend
- prepare a brief on a listed company
- trace a market figure to its date and source

## Example prompts
- List the available PreReason briefings and choose one for Treasury yields.
- Call `get_context` for rates, currencies and Bitcoin, then explain the direction of change.
- Prepare a dated company briefing and include the sources for its figures.

## Similar
- [messari-btc-eth-tracker-teneo](https://affpapa.org/en/nevibecode/skills/messari-btc-eth-tracker-teneo.md) — skill · 525 installs
- [Bitview](https://affpapa.org/en/nevibecode/mcp/bitview.md) — MCP server · ★ 177
- [emblem-portfolio-tracker](https://affpapa.org/en/nevibecode/skills/emblem-portfolio-tracker.md) — skill · 8900 installs
- [crypto-com-app](https://affpapa.org/en/nevibecode/skills/crypto-com-app.md) — skill · 1400 installs
- [ccxt-cli](https://affpapa.org/en/nevibecode/skills/ccxt-cli.md) — skill · 526 installs
- [mcp-mercado-bitcoin](https://affpapa.org/en/nevibecode/mcp/mcp-mercado-bitcoin.md) — MCP server · ★ 274

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md