Metadata-Version: 2.4
Name: magiqa-mcp
Version: 0.1.0
Summary: MCP server for MagiQa Options: covered calls, cash-secured puts, spreads, iron condors and options scanners for AI assistants
Author-email: Magiqa <info@magiqa.us>
License: MIT
Project-URL: Homepage, https://options.magiqa.us
Project-URL: Documentation, https://options.magiqa.us/documentation
Project-URL: Source, https://github.com/Avetik1980/optionsAPI
Keywords: mcp,options,covered calls,iron condor,stocks,finance,ai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp<3,>=2.3
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"

# magiqa-mcp

MCP server for [MagiQa Options](https://options.magiqa.us). Lets Claude, Cursor and other MCP clients screen US stock options with your MagiQa API key.

## Tools

| Tool | What it returns |
|---|---|
| `get_stock_snapshot` | Price, SMA/RSI/MACD, signal, trend, valuation, earnings estimates |
| `find_covered_calls` | Covered calls, one symbol or market-wide |
| `find_cash_secured_puts` | Cash-secured puts |
| `find_credit_spreads` | Bull put (bullish) or bear call (bearish) spreads |
| `find_debit_spreads` | Bull call (bullish) or bear put (bearish) spreads |
| `find_iron_condors` | Short or long iron condors |
| `find_straddles_strangles` | Long or short straddles and strangles |
| `find_high_probability_options` | Highest probability-of-profit trades |
| `get_unusual_options_activity` | Volume far above open interest |
| `get_most_active_options` | Highest options volume |
| `get_highest_open_interest` | Largest open interest |
| `get_earnings_calendar` | Upcoming earnings |

Each tool returns at most 50 rows (default 10). Option premiums are from the previous session close. Results are analytics, not investment advice.

## Setup

Get an API key at [options.magiqa.us](https://options.magiqa.us), then add the server to your MCP client.

**Claude Desktop** (`claude_desktop_config.json`) or **Cursor** (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "magiqa": {
      "command": "uvx",
      "args": ["magiqa-mcp"],
      "env": { "MAGIQA_API_KEY": "your-api-key" }
    }
  }
}
```

Without `uv`: `pip install magiqa-mcp` and use `"command": "magiqa-mcp"` with no `args`.

Your plan's rate limits and symbol access apply.
