# Aristocles

Access real-time pricing data and historical trends for dozens of subscription services across different countries. Compare plan tiers, billing cycles, and regional costs to discover cheaper alternat…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add kiranz38/aristocles-data-api

# Browse available tools
npx -y @smithery/cli@latest tool list kiranz38/aristocles-data-api

# Get full schema for a tool
npx -y @smithery/cli@latest tool get kiranz38/aristocles-data-api get_subscription_price

# Call a tool
npx -y @smithery/cli@latest tool call kiranz38/aristocles-data-api get_subscription_price '{}'
```

## Direct MCP Connection

Endpoint: `https://aristocles-data-api--kiranz38.run.tools`

**Optional config:**
- `api_key` (query) — Optional API key for Pro/Enterprise tiers. Free tier works without one

## Tools (10)

- `get_subscription_price` — Get the current price of a subscription service.
- `find_cheaper_alternatives` — Find cheaper alternatives to a subscription service.
- `get_price_history_tool` — Show how a subscription service's price has changed over time.
- `compare_services` — Side-by-side price comparison of multiple subscription services.
- `get_category_overview` — Get an overview of a spending category (e.g. "Streaming Video").
- `compare_prices_across_countries` — Compare a subscription service's price across different countries.
- `calculate_subscription_total_tool` — Calculate total monthly and annual spend for a list of subscriptions.
- `list_services_by_country_tool` — List all subscription services available in a specific country.
- `compare_billing_periods_tool` — Compare monthly vs annual pricing for a subscription service.
- `get_price_feed` — Get bulk pricing data for all services — ideal for LLM context injection.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get kiranz38/aristocles-data-api <tool-name>
```