yfinance-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YFINANCE_MCP_HOST | No | Optional environment variable that changes the bind address for the loopback HTTP server. | 127.0.0.1 |
| YFINANCE_MCP_PORT | No | Optional environment variable that changes the bind port for the loopback HTTP server. | 8772 |
| YFINANCE_MCP_ALLOW_NON_LOOPBACK | No | Set to 1 to explicitly allow a non-loopback host; otherwise a non-loopback host is rejected. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| option_expirationsC | Return available option expiration dates for a symbol. |
| option_chainC | Return a filtered contract-level option chain for one expiration. |
| option_positioning_summaryB | Summarize volume, open interest, IV and concentration for one expiration. |
| option_surface_summaryC | Summarize option positioning across up to 12 consecutive expirations. |
| option_activity_summaryC | Rank bounded multi-expiry option activity without inferring trade direction. |
| option_greeksC | Return Black-Scholes-Merton theoretical prices and greeks for one expiry. |
| option_risk_mapB | Map unsigned OI-weighted gamma concentration without inferring dealer direction. |
| option_scenarioC | Stress one option expiry across spot, IV and time using Black-Scholes-Merton. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Most tools have clear distinct purposes, but the three summary tools (option_positioning_summary, option_surface_summary, option_activity_summary) overlap significantly in scope and could be confused despite the descriptions clarifying expiry ranges and ranking intent.
All tool names follow a consistent option_ prefix with snake_case, using predictable noun-based naming that is easy to parse and remember.
Eight tools is well-scoped for an options analytics server, with each tool covering a distinct analytical aspect without excessive redundancy.
The set covers core options analytics (expirations, chain, greeks, risk, scenario), but as a yfinance-mcp server it lacks any tools for underlying stock quotes, historical prices, or fundamentals, which are notable gaps for the implied broad financial domain.