market-search

Your AI has web search. Ask it about recession risk or oil, and it summarizes articles.

This gives it market search: the live odds of recession on Kalshi and Polymarket, and the price of oil, as structured data it can read and line up on one axis.

> finance_odds --search "recession" --live

  kalshi        36.5%  vol=82,231,200   Will there be a recession in 2026?
  polymarket    36.5%  vol=1,824,634    US recession by end of 2026
  kalshi        22.5%  vol=2,965,000    Will the IMF declare a global recession before 2027?

> finance_timeseries --tickers SPY,CL=F,^VIX,KXRECSSNBER-26 --range 30d

  SPY                          22 candles   $682 → $655   -4.0%
  CL=F                         22 candles    $66 → $89   +33.8%
  ^VIX                         22 candles     21 → 26    +22.5%
  KALSHI:KXRECSSNBER-26:YES    30 candles    22% → 36%   +63.6%

25 tools, one timeseries axis. Stocks, options, futures curves, corporate bonds, government bond yields, crypto, forex, prediction markets, FRED macro, Treasury auctions, SEC filings, and central banks (Fed, ECB, BOJ, BOE, BIS). Runs on your machine. No API keys for the core data.

---

Install

Mac: download Market Search, open it, and click Connect. It finds the AI apps on your Mac and connects each one. No terminal.

Mac or Linux, in a terminal:

curl -fsSL https://eliterminal.com/install.sh | sh

Windows, in PowerShell:

irm https://eliterminal.com/install.ps1 | iex

Both install one binary and run market-search setup, which connects it to Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI, LM Studio and Zed. Restart the Claude app if it was open, then ask: "Plot the odds of a recession against the S&P 500 and oil this year."

As a plugin (macOS and Linux; adds the server plus a skill that tells the model which tool fits which question):

claude plugin marketplace add efoltyn/market-search && claude plugin install market-search@market-search   # Claude Code
codex plugin marketplace add efoltyn/market-search && codex plugin add market-search@market-search         # Codex
gemini extensions install https://github.com/efoltyn/market-search                                         # Gemini CLI

Claude app only: open market-search.mcpb to install it as a Claude Desktop extension (Mac and Windows).

Or let your AI set it up. Paste this into Claude Code, Codex or another coding agent:

Set up market-search for me: follow https://eliterminal.com/setup

From source (Rust):

cargo install --git https://github.com/efoltyn/market-search market-search

The source is open Rust, so an agent can also read it, change tools, and add providers.

---

Connect it

market-search setup lists the AI apps it found, asks once, and adds a market-search entry to each. Nothing else in your configs changes, and each file gets a backup before its first edit. --dry-run shows the changes first, --list shows what is connected, and --remove takes it out again.

Or do it by hand with the binary's full path (which market-search); apps like Claude Desktop don't see your shell's PATH. One line in Claude Code:

claude mcp add --scope user market-search -- /full/path/to/market-search mcp

Or add it to your client config (.mcp.json, Claude Desktop, Cursor, Gemini CLI):

{ "mcpServers": { "market-search": { "command": "/full/path/to/market-search", "args": ["mcp"] } } }

Self-host (optional): the server is stateless, so serving it from your own machine is one command, market-search mcp --http, behind your own TLS. market-search mcp --check shows which tools your keys unlock. See SELFHOST.md.

---

Use it from your phone

claude.ai, on the web and in the phone app, reaches tools through a public HTTPS link. On a Mac, click Set up phone access in the Market Search app. Or run one command on a Mac or Linux computer that stays on:

market-search mcp service install

It runs market-search in the background behind a free ngrok tunnel, and starts it again after a reboot. The first time, it opens the ngrok page where you copy your free authtoken. Then it prints your link and copies it:

https://your-name.ngrok-free.dev/mcp/<token>

Add it to claude.ai once:

1. Open Settings → Connectors.
2. Click Add custom connector.
3. Paste the link and click Add.

It shows up in the Claude app on your phone too. The link has a secret token in it, so keep it private.

• market-search mcp service status checks on it.
• market-search mcp service url prints the link again.
• market-search mcp service uninstall stops it.

Just trying it? market-search mcp share prints a temporary link that works while that command runs.

---

This is the beginning of the README. Read the rest at the original. Read the full README ↗