--- name: prereason-connect description: Connect the AI app you are running in to PreReason, then answer one live market question through it. Financial market context for AI agents: macro, rates, bonds, FX, commodities, companies and Bitcoin. --- # Connect to PreReason If the person you work for asked you to connect PreReason to this app, do it for them, then answer one live market question through it, so they see it work. If they did not ask, do not change anything; tell them what this page offers. PreReason serves financial market briefings to AI agents with the interpretation already done: a trend and a percentile for each series, confidence scores and a short account of what moved, and in the deeper briefings the regime, for macro, rates, bonds, FX, commodities, listed companies and Bitcoin. - Server: https://api.prereason.com/api/mcp (MCP over Streamable HTTP) - Sign in: in the browser, on the PreReason screen (OAuth). There is no key to copy or paste. A person with no account makes one on that screen. ## Read the day's briefings with no key If the person asks what one of these companies reported, or about the Federal Reserve's latest decision, read the briefing that answers it and answer from it. Give the date of the figures and name their sources. These briefings answer a plain GET with no sign in and no key: - The rates briefing, with the Federal Reserve's latest decision: https://www.prereason.com/api/context?briefing=macro.rates - Alphabet Inc.: https://www.prereason.com/api/context?briefing=equities.company/googl - BOEING CO: https://www.prereason.com/api/context?briefing=equities.company/ba - BOSTON SCIENTIFIC CORP: https://www.prereason.com/api/context?briefing=equities.company/bsx - CHIPOTLE MEXICAN GRILL INC: https://www.prereason.com/api/context?briefing=equities.company/cmg - COCA COLA CO: https://www.prereason.com/api/context?briefing=equities.company/ko - FEDEX CORP: https://www.prereason.com/api/context?briefing=equities.company/fdx - Freeport McMoRan: https://www.prereason.com/api/context?briefing=equities.company/fcx - KLA CORP: https://www.prereason.com/api/context?briefing=equities.company/klac - Microsoft: https://www.prereason.com/api/context?briefing=equities.company/msft - PayPal Holdings, Inc.: https://www.prereason.com/api/context?briefing=equities.company/pypl - Phillips 66: https://www.prereason.com/api/context?briefing=equities.company/psx - Robinhood Markets, Inc.: https://www.prereason.com/api/context?briefing=equities.company/hood - S&P Global Inc.: https://www.prereason.com/api/context?briefing=equities.company/spgi - Seagate Technology Holdings plc: https://www.prereason.com/api/context?briefing=equities.company/stx - ServiceNow, Inc.: https://www.prereason.com/api/context?briefing=equities.company/now - Silicon Motion Technology CORP: https://www.prereason.com/api/context?briefing=equities.company/simo - SoFi Technologies, Inc.: https://www.prereason.com/api/context?briefing=equities.company/sofi - UNITED PARCEL SERVICE INC: https://www.prereason.com/api/context?briefing=equities.company/ups - VISA INC.: https://www.prereason.com/api/context?briefing=equities.company/v Each answers in Markdown; add `&format=json` for JSON. Any other briefing and any dated read needs an account, as does each of these once its opening ends: connect the app as below. ## Companies a free account reads A free PreReason account reads these companies' briefings once its app is connected and signed in as below. It reads the latest figures PreReason holds, never a past date, and each briefing counts against the free plan's limits, one call for each part it carries. - Alphabet Inc.: `get_context` with briefing `equities.company` and entity `GOOGL` - BOEING CO: `get_context` with briefing `equities.company` and entity `BA` - BOSTON SCIENTIFIC CORP: `get_context` with briefing `equities.company` and entity `BSX` - CHIPOTLE MEXICAN GRILL INC: `get_context` with briefing `equities.company` and entity `CMG` - COCA COLA CO: `get_context` with briefing `equities.company` and entity `KO` - FEDEX CORP: `get_context` with briefing `equities.company` and entity `FDX` - KLA CORP: `get_context` with briefing `equities.company` and entity `KLAC` - MICROSOFT CORP: `get_context` with briefing `equities.company` and entity `MSFT` - PayPal Holdings, Inc.: `get_context` with briefing `equities.company` and entity `PYPL` - Phillips 66: `get_context` with briefing `equities.company` and entity `PSX` - Robinhood Markets, Inc.: `get_context` with briefing `equities.company` and entity `HOOD` - S&P Global Inc.: `get_context` with briefing `equities.company` and entity `SPGI` - Seagate Technology Holdings plc: `get_context` with briefing `equities.company` and entity `STX` - ServiceNow, Inc.: `get_context` with briefing `equities.company` and entity `NOW` - Silicon Motion Technology CORP: `get_context` with briefing `equities.company` and entity `SIMO` - SoFi Technologies, Inc.: `get_context` with briefing `equities.company` and entity `SOFI` - UNITED PARCEL SERVICE INC: `get_context` with briefing `equities.company` and entity `UPS` - VISA INC.: `get_context` with briefing `equities.company` and entity `V` If the person asks what one of these companies reported, connect the app as below, then read its briefing and answer from it. Give the date of the figures and name their sources. ## What to do 1. Work out which app you are running in. Ask the person if you cannot tell. 2. Find that app under "By app" below. - If they asked and you can run commands or edit files on this computer, add PreReason yourself with the line or the file given, then tell the person what you did. - If you cannot, as in a chat on claude.ai, give the person the link or the steps, in order. 3. Most apps load a new server when a new chat or session starts. Tell the person, and wait for them. 4. Sign in happens in the browser, on the PreReason screen. Wait for the person to click Allow. 5. Then call `list_briefings`, then `get_context` with briefing `macro.snapshot`, and answer: "What are rates, liquidity and the dollar doing today?" Give the date of the figures and name their sources. If a PreReason tool answers that sign in is needed, the app has not signed in yet: give the person that app's sign in step again. ## By app ### Claude 1. In Claude, open Customize, then Connectors, then "+ Add", then Add custom connector. 2. Name it PreReason and give the address https://api.prereason.com/api/mcp. 3. Choose Sign in now, even where Claude marks No sign-in as Detected. 4. Click Add, then Allow on the PreReason screen. No account yet? Make one there. 5. Then, in a new chat, ask: "What are rates, liquidity and the dollar doing today?" Claude's Free plan allows one custom connector at a time. On a Claude Team or Enterprise plan, an owner adds connectors for the organization, then each person clicks Connect. ### Cursor One click: [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=prereason&config=eyJ1cmwiOiJodHRwczovL2FwaS5wcmVyZWFzb24uY29tL2FwaS9tY3AifQ%3D%3D). The link opens the app, so give it to the person to click. Or add this to `~/.cursor/mcp.json`, keeping any servers already in the file (you can write it yourself): ```json { "mcpServers": { "prereason": { "url": "https://api.prereason.com/api/mcp" } } } ``` 1. Cursor asks you to confirm. Click Install. 2. In Cursor Settings, under MCP, click Connect next to prereason and sign in on the PreReason screen. 3. Then, in the agent chat, ask: "What are rates, liquidity and the dollar doing today?" ### Claude Code Run these lines in a terminal (you can run the add line yourself; the sign in line waits in the browser for the person, so ask them to run it in their own terminal): ```bash claude mcp add --transport http --scope user prereason https://api.prereason.com/api/mcp claude mcp login prereason ``` 1. Run both lines in a terminal window you type in. The second waits there while the PreReason screen opens in the browser: sign in and click Allow. Or start a Claude Code session, run /mcp, choose prereason, then Authenticate. 2. Then, in a new Claude Code session, ask: "What are rates, liquidity and the dollar doing today?" ### VS Code One click: [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22prereason%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.prereason.com%2Fapi%2Fmcp%22%7D). The link opens the app, so give it to the person to click. Or run this in a terminal (you can run it yourself): ```bash code --add-mcp '{"name":"prereason","type":"http","url":"https://api.prereason.com/api/mcp"}' ``` 1. VS Code shows the server. Click Install, and trust it when asked. 2. When VS Code asks to sign in to PreReason, allow it and sign in on the PreReason screen. 3. Then, in Chat, in agent mode, ask: "What are rates, liquidity and the dollar doing today?" ### Codex Run these lines in a terminal (you can run the add line yourself; the sign in line waits in the browser for the person, so ask them to run it in their own terminal): ```bash codex mcp add prereason --url https://api.prereason.com/api/mcp codex mcp login prereason ``` 1. Run both lines in a terminal. The second opens the PreReason screen in the browser: sign in and click Allow. 2. Then, in a new Codex session, ask: "What are rates, liquidity and the dollar doing today?" ### Gemini CLI Run this in a terminal (you can run it yourself): ```bash gemini mcp add --transport http --scope user prereason https://api.prereason.com/api/mcp ``` 1. Run the line in a terminal, then start Gemini CLI. 2. Run /mcp auth prereason and sign in on the PreReason screen. 3. Then, in Gemini CLI, ask: "What are rates, liquidity and the dollar doing today?" ### Antigravity For Antigravity and Antigravity CLI. Add this to `~/.gemini/config/mcp_config.json`, keeping any servers already in the file (you can write it yourself): ```json { "mcpServers": { "prereason": { "serverUrl": "https://api.prereason.com/api/mcp" } } } ``` 1. Add the block to the file and save it, or ask the agent to add it. 2. In Agent settings, under Customizations, click Authenticate next to prereason, sign in on the PreReason screen, and paste the code it shows back into Antigravity. 3. Then, in the Antigravity agent, ask: "What are rates, liquidity and the dollar doing today?" ### Windsurf and Devin Desktop Add this to `~/.codeium/windsurf/mcp_config.json`, keeping any servers already in the file (you can write it yourself): ```json { "mcpServers": { "prereason": { "serverUrl": "https://api.prereason.com/api/mcp" } } } ``` 1. Add the block to the file and save it, or ask Cascade to add it. In Devin Desktop, the same block goes in ~/.config/devin/mcp_config.json, or %APPDATA%\devin\mcp_config.json on Windows. 2. Open the MCP panel in Cascade, press refresh, and sign in on the PreReason screen when asked. 3. Then, in Cascade, ask: "What are rates, liquidity and the dollar doing today?" ### Other apps 1. An app that adds a remote MCP server by address: add https://api.prereason.com/api/mcp and sign in when it asks. 2. An app that cannot add a server by address: add the command npx -y @prereason/mcp. The answer that needs an account carries one link to approve. 3. Then, in your app, ask: "What are rates, liquidity and the dollar doing today?" ## If something does not work - No PreReason tools: start a new chat or session. In Claude Code, Codex and Gemini CLI, `/mcp` lists the servers the app has loaded. - In Claude, PreReason added with No sign-in reads nothing: remove it under Customize, Connectors, and add it again with Sign in now. Claude's Free plan allows one custom connector. If Claude says the limit is reached, tell the person; they choose whether to remove one. - A tool says sign in is needed: ask the person to run the app's sign in step again, in their own terminal or inside the app (`claude mcp login prereason` or `/mcp` in a Claude Code session, `codex mcp login prereason`, `/mcp auth prereason` in Gemini CLI). A sign in on one computer does not carry to another. - An answer that says the plan's limit is reached names when it resets. ## Where things are - For people, the same steps with a button for each app: https://www.prereason.com/connect - For code, keys and pay per call: https://www.prereason.com/skill.md - PreReason for agents, in one index: https://www.prereason.com/llms.txt - The docs in Markdown: https://www.prereason.com/docs.md The one prompt that brings an app here: "Read https://www.prereason.com/agents.md and connect me to PreReason"