Prereason

by PreReason

4 stars

359 downloads

Not rated

GitHub

About

MCP server for PreReason, the Context API for financial agents. 17 pre-reasoned market briefings with trend signals, regime classification, confidence scores, and cross-asset correlations.

Details

Author: PreReason
GitHub stars: 4
Downloads: 359
Categories: Other, Finance, AI

- 5 MCP tools: list_briefings, list_metrics, get_health, get_context, get_metric
- 17 pre-reasoned market briefings (6 free, 5 Basic, 6 Pro)
- 30 available metrics across bitcoin, macro, and calculated categories
- OAuth support for one-click client connection
- HTTP and stdio transport options
- Trend signals, confidence scores, and causal narratives per briefing

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Prereason

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

From the repository

Connect via one-click OAuth (Claude.ai, ChatGPT, Cursor, Codex, Windsurf, VS Code Copilot) by adding the server URL https://api.prereason.com/api/mcp. Alternatively, use direct HTTP with an API key (for Claude Code, scripts) or a stdio bridge for Claude Desktop (requires Node.js 18+). Get a free API key at prereason.com/signup.

`list_briefings`

List all available pre-reasoned market briefings with tier requirements. Returns 18 LIVE briefings across Free (6), Basic (6), and Pro (6) tiers. Covers Bitcoin, macro, FX, commodities, and cross-asset financial data categories. No authentication required.

`list_metrics`

List all available individual metrics (119 metrics across bitcoin, macro, and calculated categories). Includes Bitcoin price, hash rate, Fed balance sheet, M2 supply, Treasury 10Y yield, net liquidity, and cross-asset indices (SPY, QQQ, VXX, UUP) used as BTC correlation signals. Optionally filter by category or search term. No authentication required.

`get_health`

Check API health status, version, and available endpoints. No authentication required.

`get_context`

Get a pre-reasoned market briefing with trend signals, confidence scores, regime classification, and causal narratives for the requested domain (Bitcoin, macro, cross-asset, FX). Includes crypto, macro financial data, and cross-asset correlations (indices, bonds, volatility as BTC relationship signals). Output is decision-ready — designed to be consumed directly by reasoning agents, not parsed for individual values. Briefings are tier-gated: Free (btc.quick-check, btc.context, macro.snapshot, cross.correlations, btc.pulse, btc.grid-stress), Basic (btc.momentum, macro.liquidity, btc.on-chain, cross.breadth, btc.miner-survival, btc.etf-flows), Pro (btc.full, btc.factors, cross.regime, fx.liquidity, btc.energy, btc.treasury). Requires API key authentication via Authorization header.

`get_metric`

Get a single metric with pre-reasoned signal interpretation, trend analysis (7d/30d/90d), confidence score with factor breakdown, momentum, and percentile ranking. Available metrics: bitcoin-price, bitcoin-market-cap, bitcoin-volume-24h, bitcoin-change-24h, bitcoin-dominance, bitcoin-hash-rate, bitcoin-difficulty, bitcoin-tx-count, bitcoin-tx-volume, bitcoin-active-addresses, fed-balance, m2-supply, treasury-10y, rrp, eur-usd, cny-usd, yield-curve, tga, treasury-3mo, treasury-2y, treasury-5y, treasury-30y, breakeven-5y, breakeven-10y, t5yifr, mortgage-30y, t10y3m-spread, auction-bid-to-cover-10y, auction-bid-to-cover-30y, indirect-bidder-pct, dealer-takedown-pct, next-treasury-auction-days, fed-funds-rate, ecb-deposit-rate, boj-policy-rate, fed-ecb-spread, fed-boj-spread, carry-trade-returns-proxy, carry-trade-velocity-1d, mortgage-treasury-spread, iwm-spy-credit-spread, spy-vxx-correlation-30d, regime-stability-flag, jpy-usd, oil-brent, oil-wti, ovx, real-rate-10y, gld-gdx-ratio, copper-gold-ratio, slv-sil-ratio, gdxj-gdx-ratio, gold-silver-ratio, brent-wti-spread, etf-gld-1h-velocity, etf-cper-1h-velocity, etf-uso-1h-velocity, etf-uup-velocity-1h, crude-oil-stocks, natgas-storage, oil-inventory-zscore, natgas-storage-zscore, ecb-boj-spread, etf-gld-volume, etf-uso-volume, etf-uup-volume, etf-gld-volume-zscore-30d, etf-uso-volume-zscore-30d, etf-uup-volume-zscore-30d, net-liquidity, hash-ribbon, mvrv-proxy, etf-spy, etf-qqq, etf-iwm, etf-vxx, etf-uup, etf-gld, etf-gdx, etf-gdxj, etf-slv, etf-sil, etf-uso, etf-ung, etf-cper, etf-weat, etf-tlt, etf-ibit, etf-fxe, etf-fxy, usdt-market-cap, usdt-dominance, btc-price-200d-ma, btc-price-200d-distance, btc-etf-net-flow, btc-etf-cumulative-flow, btc-etf-aum, btc-etf-ibit-flow, btc-etf-fbtc-flow, btc-etf-gbtc-flow, btc-etf-other-flow, btc-etf-ibit-aum, btc-etf-fbtc-aum, btc-etf-bitb-aum, btc-etf-arkb-aum, btc-etf-btco-aum, btc-etf-ezbc-aum, btc-etf-brrr-aum, btc-etf-hodl-aum, btc-etf-btcw-aum, btc-etf-gbtc-aum, btc-etf-btc-aum, bitcoin-price-1h-change-pct, raw-hashprice-tick, on-chain-velocity-30d, bitcoin-volume-zscore-30d, btc-perp-oi-contracts, btc-perp-positioning-regime, btc-perp-funding-zscore-30d. Requires API key authentication. Returns analyzed context (signal, trend direction, momentum, 90d percentile), not raw values. Use when you need to understand what a metric means for decision-making, not just its number.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "prereason": {
            "prereason": {
                "command": "npx",
                "args": [
                    "-y",
                    "@prereason/mcp"
                ],
                "env": {
                    "PREREASON_API_KEY": "your-api-key"
                }
            }
        }
    }
}

McpServers

{
    "prereason": {
        "command": "npx",
        "args": [
            "-y",
            "@prereason/mcp"
        ],
        "env": {
            "PREREASON_API_KEY": "your-api-key"
        }
    }
}

@prereason/mcp

MCP server for PreReason - the Context API for financial agents.

Give your agent market context, not raw price feeds. 17 briefings covering BTC, macro,<br>
cross-asset regimes, and liquidity - each with trend signals, confidence scores, and causal narratives.

</div>

Quick Start

Option 1: One-Click Connect (Claude.ai, ChatGPT, Cursor, Codex, Windsurf, VS Code Copilot)

Clients that support MCP OAuth can connect with no API key setup required. Add the server URL and the client handles the rest - you'll be prompted to sign in or create a free account, and your API key is provisioned automatically.

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

No Authorization header needed - OAuth handles it.

Option 2: Direct HTTP with API Key (Claude Code, scripts, cron jobs)

For CLI tools or when you want to use an existing API key:

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Prereason

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

`list_briefings`

`list_metrics`

`get_health`

`get_context`

`get_metric`

Claude Desktop / Cursor

McpServers

@prereason/mcp

Quick Start

Option 1: One-Click Connect (Claude.ai, ChatGPT, Cursor, Codex, Windsurf, VS Code Copilot)

Option 2: Direct HTTP with API Key (Claude Code, scripts, cron jobs)

Install

About

Details

Jump to

Setting up with Highlight

From the repository

list_briefings

list_metrics

get_health

get_context

get_metric

Claude Desktop / Cursor

McpServers

@prereason/mcp

Quick Start

Option 1: One-Click Connect (Claude.ai, ChatGPT, Cursor, Codex, Windsurf, VS Code Copilot)

Option 2: Direct HTTP with API Key (Claude Code, scripts, cron jobs)

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Context 7

Reactive Resume

`list_briefings`

`list_metrics`

`get_health`

`get_context`

`get_metric`