# Coil for AI agents

Coil is a stock market MCP server that gives your AI agent judgment, not just prices: a trading desk's discipline (when to trade, when to wait, when to sit in cash) plus the scores to act on. It is an impersonal research publication: a scored board of 650+ US stocks and ETFs plus a BTC/ETH crypto book, re-scored about every 5 minutes through the US market day on Coil Live (the free tools are a sample of the morning read, below). It reads and ranks; it does not trade, place orders or manage money, and nothing here is investment advice.

Canonical site: https://coil.trade
This document: https://coil.trade/agents.md
Human version: https://coil.trade/agents

## What Coil is and is not

- A research publication: market regime, a ranked buy list, single-stock and sector reads, market leaders, and BTC/ETH trend gates.
- Not a broker, not an execution service, not advice. Any order is placed by you or your own agent at your own broker.

## The routine

A trading desk reads the market top-down, and a connected agent learns the same order. First the gate, get_market_regime: whether the market is worth trading today. On a cash reading the discipline opens nothing new, because cash is a position. Then where money is moving, get_rotation and get_sector_read. Then the names that are set up, get_buy_list, each with its entry window: a name inside its window is a candidate, a name far above it is a chase. Then one name before any buy, get_stock_read. And for what is already owned, get_hold_state: a broken trend ends the thesis, and exits come before entries. Every free answer closes with the rule that applies. Coil Live serves the same routine live, with each name's structural stop, target and conviction (get_engine_feed) and the versioned rulebook an agent trades against (get_live_rules).

## Connect over MCP

- Endpoint: https://mcp.coil.trade/mcp
- Transport: streamable HTTP
- Registry name: trade.coil/stock-market-scanner (official MCP Registry: https://registry.modelcontextprotocol.io/v0/servers?search=trade.coil)
- Free, no sign-in for the free tools: a sample of the board's morning read (top 3 per book, headline fields), with no payment, no key and no account.

One-click installs:

- Claude (claude.ai, Desktop, mobile): https://claude.ai/directory/connectors/coil
- Claude Code: `claude mcp add --transport http coil https://mcp.coil.trade/mcp`
- Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=coil&config=eyJ1cmwiOiJodHRwczovL21jcC5jb2lsLnRyYWRlL21jcCJ9
- VS Code: https://vscode.dev/redirect/mcp/install?name=coil&config=%7B%22name%22%3A%22coil%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.coil.trade%2Fmcp%22%2C%22type%22%3A%22http%22%7D
- Goose: goose://extension?type=streamable_http&id=coil&name=Coil%20Live&url=https%3A%2F%2Fmcp.coil.trade%2Fmcp&description=Coil%20scored%20stock%20board%2C%20free%20delayed%20sample%2C%20no%20sign-in
- LM Studio: lmstudio://add_mcp?name=coil&config=eyJ1cmwiOiJodHRwczovL21jcC5jb2lsLnRyYWRlL21jcCJ9

Most other clients take this in their MCP config:

```json
{"mcpServers":{"coil":{"url":"https://mcp.coil.trade/mcp"}}}
```

## Auth

- The free tools need no sign-in and no key. They return a sample of the board's morning read (top 3 per book, headline fields).
- Coil Live sign-in uses OAuth on the same endpoint. How access works, step by step: https://coil.trade/auth.md

## Tools

Free tools (a sample of the board's morning read): get_market_regime, get_buy_list, get_stock_read, get_market_leaders, get_sector_read, get_crypto_trend, get_morning_brief, get_day_board, get_rotation, get_crypto_day, get_crypto_night, get_crypto_setups, get_hold_state.

The full tool list is in the server card: https://coil.trade/.well-known/mcp/server-card.json

## Pay per read over x402

Agents with a wallet can also pay per read over x402, with no account and no key: https://coil.trade/agents#pay

## More

- llms.txt: https://coil.trade/llms.txt
- Discovery manifest: https://coil.trade/.well-known/mcp.json
- Server card: https://coil.trade/.well-known/mcp/server-card.json
- Terms: https://coil.trade/terms
- Privacy: https://coil.trade/privacy
