# Set up market-search

You are an AI agent and the person you work for asked you to set up market-search.
Do the steps below yourself, then tell them in two or three plain sentences what you did.

market-search gives AI apps live market data as MCP tools: Kalshi and Polymarket odds,
stocks, futures, options, corporate and government bonds, FRED macro, Treasury auctions,
central banks and SEC filings, all on one timeseries axis. It runs on this computer and
makes requests from this computer's connection. The core data needs no API keys.

## 1. Install and connect

macOS or Linux:

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

Windows (PowerShell):

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

This installs one binary (~/.local/bin/market-search; on Windows
%LOCALAPPDATA%\market-search\market-search.exe) and runs `market-search setup --yes`,
which adds market-search to every AI app it finds: Claude Desktop, Claude Code, Cursor,
VS Code, Windsurf, Codex, Gemini CLI, LM Studio and Zed. It only adds an entry named
"market-search", backs up each config file before its first change, and never rewrites
a file it cannot parse.

## 2. Check

    ~/.local/bin/market-search setup --list

If an app the person uses shows "not connected", run
`market-search setup --yes --client <id>` (ids: claude-desktop, claude-code, cursor,
vscode, vscode-insiders, windsurf, codex, gemini-cli, lm-studio, zed).

## 3. SEC filings (optional)

The filings and insider tools need a contact for the SEC. Ask the person for an email,
then run:

    market-search setup --yes --sec-contact "their@email.com"

## 4. Restart

New tools load on restart. Tell the person to quit and reopen the Claude app if it was
open, and to start a new session in Claude Code, Codex or Gemini CLI. You will see tools
named finance_timeseries, finance_odds, finance_filings and so on.

## 5. Phone and claude.ai on the web (optional)

claude.ai reaches market-search through a private link to a computer that stays on.
On that computer:

    market-search mcp service install

It runs market-search in the background with a tunnel, survives restarts, and prints a
link. The first time it needs a free ngrok token
(https://dashboard.ngrok.com/get-started/your-authtoken). The person pastes the link into
Claude: Settings, Connectors, Add custom connector. On a Mac, the Market Search app
(https://github.com/efoltyn/market-search/releases/latest/download/MarketSearch.dmg)
does this with a button.

## 6. Try it

Ask: "Plot the odds of a recession against the S&P 500 and oil this year."

Source and docs: https://github.com/efoltyn/market-search