Metadata-Version: 2.4
Name: tepilora-mcp
Version: 0.1.0
Summary: MCP server for Tepilora financial API
Author-email: Tepilora <info@tepiloradata.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Admintepilora/TepiloraMCP
Project-URL: Repository, https://github.com/Admintepilora/TepiloraMCP
Project-URL: Bug Tracker, https://github.com/Admintepilora/TepiloraMCP/issues
Project-URL: Documentation, https://github.com/Admintepilora/TepiloraMCP#readme
Keywords: tepilora,mcp,finance,api,llm,claude
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Tepilora>=0.3.2
Requires-Dist: fastmcp<3,>=2.14
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
Dynamic: license-file

# Tepilora MCP Server

MCP (Model Context Protocol) server for the [Tepilora](https://pypi.org/project/Tepilora/) financial API.

Gives AI assistants (Claude, Codex, etc.) native access to **226 financial data operations** — securities search, portfolio analytics, news, bonds, and more.

## Install

```bash
pip install tepilora-mcp
```

## Quick Start

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "tepilora": {
      "command": "tepilora-mcp",
      "env": {
        "TEPILORA_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add tepilora tepilora-mcp -e TEPILORA_API_KEY=your-api-key
```

### Run Directly

```bash
export TEPILORA_API_KEY=your-api-key
tepilora-mcp
```

## Available Tools

### Discovery

| Tool | Description |
|------|-------------|
| `list_namespaces` | List all 23 API namespaces with operation counts |
| `list_operations` | List operations for a namespace |
| `describe_operation` | Get parameter details for any operation |
| `call_operation` | Execute any of the 226 operations |

### Curated

| Tool | Description |
|------|-------------|
| `search_securities` | Search stocks, ETFs, bonds, funds |
| `get_security_details` | Get security information |
| `get_price_history` | Historical price data |
| `create_portfolio` | Create a portfolio |
| `get_portfolio_returns` | Portfolio return analysis |
| `run_analytics` | Run any of 68 analytics functions |
| `search_news` | Search financial news |
| `screen_bonds` | Screen bonds by criteria |
| `get_yield_curve` | Yield curve data |

### Full Mode

Set `TEPILORA_MCP_FULL_TOOLS=true` to expose all 226 operations as individual tools.

## Configuration

| Environment Variable | Required | Default | Description |
|---------------------|----------|---------|-------------|
| `TEPILORA_API_KEY` | Yes | - | Your Tepilora API key |
| `TEPILORA_BASE_URL` | No | `https://tepiloradata.com` | API base URL |
| `TEPILORA_MCP_FULL_TOOLS` | No | `false` | Register all 226 operations as tools |
| `TEPILORA_MCP_TIMEOUT` | No | `30` | Request timeout in seconds |

## API Coverage

23 namespaces, 226 operations:

| Namespace | Ops | Examples |
|-----------|-----|---------|
| securities | 12 | search, filter, history, facets |
| portfolio | 19 | create, returns, attribution, optimize |
| analytics | 68 | rolling volatility, Sharpe, drawdown, VaR |
| news | 7 | search, latest, trending |
| bonds | 7 | analyze, screen, curve, spread |
| stocks | 9 | technicals, screening, peers |
| options | 6 | pricing, Greeks, IV |
| macro | 6 | economic indicators, calendar |
| esg | 5 | scores, screening |
| *+ 14 more* | | alerts, billing, clients, documents, ... |

## License

MIT
