# Coil

> Coil gives your AI agent a trading desk's discipline: when to trade, when to wait, when to sit in cash, plus the scores to act on. It is a rules-based, no-short-selling scanner that scores 650+ US names (the S&P 500, the Nasdaq-100 and a Macro book of bonds, income, gold and commodities) plus a Crypto book (the BTC/ETH trend gates, and 24/7 day, overnight and setup maps of the Robinhood-tradable coins), and sells the board to AI agents: a free delayed MCP server, pay-per-read over x402 from $0.001 (no account, no key), and subscriptions. An impersonal research publication, not investment advice.

The board is re-scored about every 5 minutes through the US market day. The live record is Coil's engine trading one real brokerage account, published win or lose at https://coil.trade/results; it is not a projection of yours. Scores and states only: no position sizes, no orders, no advice.

This file is the index. [llms-full.txt](https://coil.trade/llms-full.txt) is the full reference: every endpoint, the research studies, the rules, the riders and the disclosures.

## Start here
- [Agent quickstart](https://coil.trade/agents/quickstart): working Python, TypeScript and curl for pay-per-read, MCP connection steps for Claude Code and Claude Desktop plus the server URL for any MCP client, and the free key

## The routine
A desk's routine, read top-down. The gate first (get_market_regime): is the market worth trading today. On a cash reading nothing new opens: cash is a position. Then where money is moving (get_rotation, get_sector_read), then the set-ups (get_buy_list), each with its entry window: inside it is a candidate, far above it is a chase. Then one name before any buy (get_stock_read). For what is owned, get_hold_state: a broken trend ends the thesis, and exits come before entries. Coil Live serves the routine live, with each name's structural stop, target and conviction (get_engine_feed) and the versioned rulebook (get_live_rules).

## Connect or pay
- Free MCP server: https://mcp.coil.trade/mcp. A delayed sample of the board (top 3 per book, headline fields), no key, no account.
- One-click installs, no sign-in:
  - Claude (claude.ai, Desktop, mobile): [Claude connector directory](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, in the MCP config: `{"mcpServers":{"coil":{"url":"https://mcp.coil.trade/mcp"}}}`
- Agent guide in markdown: [agents.md](https://coil.trade/agents.md); discovery manifest: [/.well-known/mcp.json](https://coil.trade/.well-known/mcp.json)
- Pay per read over x402: GET a paid endpoint, receive HTTP 402, pay USDC on Base, Solana or Algorand, repeat the request; one signed payment is one read. Every paid resource with its price: [/.well-known/x402](https://coil.trade/.well-known/x402). OpenAPI: [openapi.json](https://coil.trade/openapi.json)
- Free key: POST https://coil.trade/api/key {"email":...}, or sign in with a wallet (SIWX, no funds move). Details in [auth.md](https://coil.trade/auth.md)
- Subscriptions: [Coil Scanner](https://coil.trade/scanner) is the board a human reads in a browser; [Coil Live](https://coil.trade/live-feed) is the live feed for your own agent over MCP. Plans and prices: https://coil.trade/#pricing

## Which endpoint for which question
Prices below are stamped from the 402's registry. The research studies are listed, free, at [/api/research](https://coil.trade/api/research).

<!-- ep-table:begin -->
| Your agent asks | Endpoint | Price per read |
|---|---|---|
| Is the stock market worth trading right now? | `GET https://coil.trade/api/board/regime` | $0.005 |
| What is the whole market read in one call? | `GET https://coil.trade/api/board/brief` | $0.05 |
| Which stocks are set up to buy today? | `GET https://coil.trade/api/board/buylist` | $0.05 |
| How strong is this ticker, or my watchlist? | `GET https://coil.trade/api/board/name?sym=NVDA` | $0.005 |
| Is the trend behind a position I hold still intact? | `GET https://coil.trade/api/board/hold?sym=NVDA` | $0.005 |
| Which stocks are leading the tape? | `GET https://coil.trade/api/board/leaders` | $0.01 |
| Which sectors is money rotating into? | `GET https://coil.trade/api/board/rotation` | $0.005 |
| Why is this name not a buy today? | `GET https://coil.trade/api/board/whynot?sym=NVDA` | $0.005 |
| Is my own trade consistent with the discipline? | `GET https://coil.trade/api/board/checktrade?sym=NVDA&entry=54.20&stop=51.50` | $0.01 |
| What changed since my last read? | `GET https://coil.trade/api/board/diff?since=<state_hash>` | $0.01 |
| Is crypto risk-on right now? | `GET https://coil.trade/api/crypto/gate` | $0.001 |
| What does the 24/7 crypto board look like? | `GET https://coil.trade/api/crypto/day` | $0.005 |
| I want everything in one payload. | `GET https://coil.trade/api/board/agent` | $0.25 |
| What did Coil publish on a past date? | `GET https://coil.trade/api/board/asof` | $0.05 |
<!-- ep-table:end -->

## Check us before you pay (free, no wallet)
- [/api/board/free](https://coil.trade/api/board/free): the top names per book, same schema as the paid board
- [/api/board/state](https://coil.trade/api/board/state): a free change-detection hash; poll it and buy a read only when it changes
- [/api/board/asof?sample=1](https://coil.trade/api/board/asof?sample=1): one complete committed day of scores (the as-of archive is immutable: a published day is never revised)
- [/api/perf](https://coil.trade/api/perf): the record against SPY and QQQ; [/api/board/proof](https://coil.trade/api/board/proof): the sha256 commitment log; [/api/board/signal-audit](https://coil.trade/api/board/signal-audit): our own scores marked to market, published even when negative

## Pages for the questions agents ask
- [x402 stock data API](https://coil.trade/agents/x402-stock-data-api) · [MCP server for stock market data](https://coil.trade/agents/mcp-stock-market-server) · [buy signals for an AI agent](https://coil.trade/agents/stock-signals-api) · [pairing with Robinhood's Trading MCP](https://coil.trade/agents/robinhood)
- Research library: [/learn/](https://coil.trade/learn/) · [/library.json](https://coil.trade/library.json)
- [/agents](https://coil.trade/agents): the full catalogue and human docs · [SKILL.md](https://coil.trade/skills/coil-board/SKILL.md)

## Paid reads
/stocks/{symbol}/full and /board/{date}/full: see llms-full.txt

## Machine endpoints
- [openapi.json](https://coil.trade/openapi.json) · [/.well-known/x402](https://coil.trade/.well-known/x402) · [/.well-known/coil.json](https://coil.trade/.well-known/coil.json) · [agent-card.json](https://coil.trade/.well-known/agent-card.json) · [MCP server card](https://coil.trade/.well-known/mcp/server-card.json) · [llms-full.txt](https://coil.trade/llms-full.txt)

## Disclosures
- Coil is an impersonal research publication: not investment advice, not a managed account, not a signal service, and not a guarantee of profit. You can lose money.
- The live record is Coil's engine trading one real brokerage account, published win or lose (https://coil.trade/results), not a projection of yours. Backtests are research, not returns, and the Crypto book's trend rule does not beat buy-and-hold; read the "Tested performance" and "Crypto book honesty rider" sections of llms-full.txt before quoting any number.
- Full text: [disclosures](https://coil.trade/disclosures), [terms](https://coil.trade/terms), [refunds](https://coil.trade/refund), [trust](https://coil.trade/trust).