# spicytrade

> Options market data and research for US equities and ETFs -- quotes, implied-volatility
> metrics, a catalyst calendar, and a daily options brief -- with guarded order placement
> through a member's own tastytrade account. Agents should use the MCP server at
> https://spicy.trade/mcp rather than scraping the web app.

The web app is client-rendered; its views need JavaScript. Each published brief and each
symbol on the public watchlist also has a server-rendered page that reads without it. Every
account read and every order goes through the MCP server, never through the web app, and the
server's own guards decide what is admissible.

## MCP server

- [MCP endpoint (Streamable HTTP)](https://spicy.trade/mcp): Connect directly with no credential for the public tier: the site's cached snapshot quotes, catalysts, research reads and the daily brief.
- [Connect in the current agent](https://spicy.trade/connect/guide): Follow this guide to install the local connector, register only the current harness in its workspace, and approve browser authorization without launching a new agent. The connector keeps credentials in the OS keyring; no MCP configuration holds a credential.
- [Local MCP server installer](https://spicy.trade/install.sh): Use `--connector-only` for agent-driven onboarding. Manual terminal setup remains available.
- [OAuth protected resource metadata](https://spicy.trade/.well-known/oauth-protected-resource/mcp): How an HTTP MCP client discovers sign-in for the endpoint.
- [Full agent guide](https://spicy.trade/llms-full.txt): This file plus the guide the MCP server publishes as its `spicytrade://guide` resource.

## Public JSON

- [Market snapshot](https://spicy.trade/api/public-snapshot): The tracked watchlist's tickers, catalysts, market state, and the latest brief.
- [Symbol search](https://spicy.trade/api/public-symbol-search): `?q=` one ticker or company name; a resolved name may be added to the tracked watchlist.
- [Catalysts](https://spicy.trade/api/public-catalysts): `?symbol=` dated events for one symbol, with sources.
- [Brief archive](https://spicy.trade/api/public-daily-briefs): `?before=YYYY-MM-DD` the latest daily brief published before that market date.

## Pages

- [Watch](https://spicy.trade/watch): The market table and one symbol's detail.
- [Recommendations](https://spicy.trade/recommendations): The daily options brief and its archive.
- [Brief archive](https://spicy.trade/briefs): Every published daily brief by market date, server-rendered, linking to one page per brief at `/briefs/YYYY-MM-DD`.
- [Symbol pages](https://spicy.trade/sitemap.xml): One server-rendered page per symbol on the public watchlist at `/options/SYMBOL` -- price, IV rank and percentile, volatility, liquidity, stored catalysts, and the latest brief recommendation; the sitemap lists them all.
- [Connect](https://spicy.trade/connect): Setup commands for connecting an agent.

## Optional

- [Terms](https://spicy.trade/terms)
- [Privacy](https://spicy.trade/privacy)
- [Disclosures](https://spicy.trade/disclosures)