Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/tradingvolatility/tv-mcp/agents-mdgit clone --depth 1 https://github.com/tradingvolatility/tv-mcpWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/tradingvolatility/tv-mcp/agents-md)<a href="https://agentmods.dev/instructions/tradingvolatility/tv-mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/tradingvolatility/tv-mcp/agents-md.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00740 | $0.00740 |
| Opus 5 | $0.00370 | $0.00370 |
| Sonnet 5 | $0.00148 | $0.00148 |
| Haiku 4.5 | $0.00074 | $0.00074 |
Grade A, and why
tv-mcp AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 56 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Trading Volatility MCP — for AI agents
This is a Model Context Protocol server that gives agents read-only access to Trading Volatility options market-structure data: GEX, gamma flip levels, dealer positioning, volatility skew, max pain, expected-move levels, options volume, and cross-ticker ranked trade setups.
It is a stateless passthrough over the public v2 API — it discovers and retrieves data, and never places orders or takes payments.
Connect
- Endpoint:
POST <this-server>/mcp— Streamable HTTP + SSE (standard MCP transport). - Auth: send your Trading Volatility API key as
Authorization: Bearer <key>(X-Api-Key: <key>also works). - No key? The demo tickers — AAPL, VIX, KO, META, AMZN, XOM, GM, MCD — work without one.
- Local:
uvx tv-mcpruns the same server over stdio.
First call
Call list_capabilities first. It returns the v2 /llm-spec manifest — the full set of
endpoints, metrics, expirations, regimes, and screener names — so you can self-orient before
querying. Call get_auth_status to see whether you're in keyed or demo mode.
Tools
| Tool | Returns |
|---|---|
list_capabilities |
The v2 capability manifest (/llm-spec) — call first |
get_auth_status |
Whether you're in keyed or demo mode |
get_ticker_state |
Canonical compact state snapshot for a ticker |
explain_ticker |
Deterministic narrative interpretation of the regime |
get_market_structure |
Headline signal, regime, expected behavior, levels |
get_signals |
Current setup/positioning signals |
get_levels |
Key levels (json / tradingview / tos) |
get_series |
Historical daily series for selected metrics over a window |
get_gamma_curve |
Gamma strike curve (per expiration, optionally realtime) |
get_gamma_by_expiration |
Gamma decomposition by expiration bucket |
get_gex_by_strike |
Net GEX strike curve with call/put contributions |
get_options_volume |
Options volume by strike for an expiration |
rank_top_setups |
Cross-ticker opportunity ranking, with filters |
run_screener |
A named thesis preset over the ranking |
rank_income_setups |
Cross-ticker covered-call / cash-secured-put ranking, with filters |
get_trade_setup |
Compact agent-oriented trade setup for one ticker |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 4d ago First seen · 56 lines · 740 tokens per session scan A b2eb8116e46d
tv-mcp AGENTS.md is an instructions file published in the GitHub repository tradingvolatility/tv-mcp (1 stars, last pushed 2mo ago), licensed MIT. It adds 740 tokens to every session, about $0.0037 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
ClawRouter CLAUDE.md
Claude Code instructions for BlockRunAI/ClawRouter, covering clawrouter, commands, project structure, key dependencies and conventions.
InvestSkill GEMINI.md
Gemini CLI instructions for yennanliu/InvestSkill, covering investskill — gemini cli setup & usage guide, installation & setup, quick start, navigate to the investskill directory and start gemini cli (loads gemini.md automatically).
LLM-TradeBot copilot-instructions.md
Copilot instructions for EthanAlgoX/LLM-TradeBot, covering repository instructions, core rules, validation and ai asset governance.
Convertible-Bond-Pricing-Research CLAUDE.md
Instructions for ericxuzhesheng/Convertible-Bond-Pricing-Research, covering claude.md — convertible bond pricing research, current published state and routine commands.
bukio-cli AGENTS.md
AGENTS.md instructions for erikvankempen/bukio-cli, covering agents.md — bukio-cli agent manual, 1. house rules (non-negotiable), 2. environment, 3. command quick reference and 3.1 jurisdiction profiles (16 markets).
swiss-snb-mcp CLAUDE.md
Claude Code instructions for malkreide/swiss-snb-mcp, covering claude.md, teil 1 — konventionen (portfolio-weit), vor der arbeit, tests and wenn etwas rot ist.