Metadata-Version: 2.4
Name: esimturkei-mcp
Version: 0.1.0
Summary: Model Context Protocol server for e-simturkei.de — query eSIM providers and plans for Turkey directly from Claude Desktop, Cursor, or any MCP-aware AI agent.
Project-URL: Homepage, https://www.e-simturkei.de
Project-URL: API Docs, https://www.e-simturkei.de/api
Project-URL: OpenAPI Spec, https://www.e-simturkei.de/api/v1/openapi.json
Project-URL: Repository, https://github.com/esimturkei/esimturkei-mcp
Project-URL: Bug Tracker, https://github.com/esimturkei/esimturkei-mcp/issues
Author-email: "e-simturkei.de" <kontakt@e-simturkei.de>
License: MIT
License-File: LICENSE
Keywords: ai,claude,esim,llm,mcp,travel,turkey
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# esimturkei-mcp

> Model Context Protocol server for [e-simturkei.de](https://www.e-simturkei.de) — Germany's leading independent Turkey eSIM comparison platform.

Wire eSIM provider and plan data for Turkey directly into **Claude Desktop**, **Cursor**, **Cline**, or any MCP-aware AI agent. One command install.

## Install

```bash
# Pick whichever you have:
uvx esimturkei-mcp
pipx install esimturkei-mcp
pip install esimturkei-mcp
```

## Claude Desktop / Cursor Config

Add to your `claude_desktop_config.json` or Cursor MCP settings:

```json
{
  "mcpServers": {
    "esimturkei": {
      "command": "uvx",
      "args": ["esimturkei-mcp"]
    }
  }
}
```

Then ask:
- *"What is the cheapest eSIM for 7 days in Turkey with hotspot support?"*
- *"Which eSIM provider has the best coverage in Cappadocia?"*
- *"Compare Airalo and Saily for Turkey — prices, features, networks"*
- *"Find all unlimited Turkey eSIM plans under €20"*

## Tools

| Tool | Description |
|---|---|
| `list_providers` | All 12 tested providers with network, price, and feature flags |
| `get_provider` | Full profile + all plans for a specific provider |
| `list_plans` | Filter plans by price, data, duration, network, plan type |
| `search` | Full-text search across providers and plans |
| `get_cheapest` | Find cheapest plan for given requirements |

Plus a `esimturkei://about` resource with site metadata and key facts.

## Data

- **Source**: [e-simturkei.de](https://www.e-simturkei.de) — independently tested, updated monthly
- **API**: [e-simturkei.de/api](https://www.e-simturkei.de/api)
- **OpenAPI spec**: [e-simturkei.de/api/v1/openapi.json](https://www.e-simturkei.de/api/v1/openapi.json)
- **No affiliate links** are exposed — `pageUrl` fields link to e-simturkei.de for full details
- **Networks covered**: Turkcell, Türk Telekom, Vodafone Turkey

## Requirements

- Python 3.10+
- No API key needed

## License

MIT
