{
  "markdown": "# @apogeoapi/mcp\n\nMCP (Model Context Protocol) server for [ApogeoAPI](https://app.apogeoapi.com) — geographic data, live exchange rates, and IP geolocation for Claude Desktop, Cursor, and any MCP-compatible AI assistant.\n\n## What it does\n\nThis server exposes ApogeoAPI's REST endpoints as tools that AI assistants can call directly. Ask Claude \"What is the current USD rate for Argentina?\" or \"Geolocate IP 8.8.8.8\" and it will call the right tool automatically.\n\n## Available tools\n\n| Tool | Description | Plan required |\n|------|-------------|---------------|\n| `get_country` | Full country data by ISO2/ISO3 code — name, capital, region, population, currency, live USD rate, timezones, phone code | Free |\n| `list_countries` | Paginated list of all 250+ countries | Free |\n| `search_countries` | Search countries by partial name | Free |\n| `get_states` | All states/provinces for a country | Basic+ |\n| `get_cities` | All cities for a state by numeric state ID | Basic+ |\n| `get_currency_rate` | Live USD exchange rate for a country's currency (updated every 4 hours) | Basic+ |\n| `geolocate_ip` | Country, region, city, coordinates, timezone, and EU membership for any IPv4/IPv6 | Basic+ |\n| `global_search` | Search across countries, states, and cities in one query | Free |\n\n## Installation\n\n### Claude Desktop\n\nAdd the following to your `claude_desktop_config.json`:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"apogeoapi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@apogeoapi/mcp\"],\n      \"env\": {\n        \"APOGEOAPI_KEY\": \"apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving the file. The ApogeoAPI tools will appear in Claude's tool list.\n\n### Cursor\n\nAdd the same block under `mcpServers` in Cursor's MCP configuration file (`~/.cursor/mcp.json`).\n\n### Manual build\n\n```bash\ngit clone https://github.com/APOGEOAPI/apogeoapi-mcp.git\ncd apogeoapi-mcp\nnpm install\nnpm run build\n```\n\nThen reference the built file directly:\n\n```json\n{\n  \"mcpServers\": {\n    \"apogeoapi\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mcp-server/dist/index.js\"],\n      \"env\": {\n        \"APOGEOAPI_KEY\": \"apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n## Getting an API key\n\n1. Create a free account at [app.apogeoapi.com](https://app.apogeoapi.com)\n2. Go to **API Keys** and generate a new key\n3. Paste the key into the `APOGEOAPI_KEY` environment variable above\n\nNo credit card required for the Free plan (1,000 req/month).\n\n## Plan requirements\n\n| Feature | Free | Basic ($19/mo) | Starter ($29/mo) | Professional ($79/mo) |\n|---------|------|----------------|-------------------|-----------------------|\n| Countries (list, search, get) | Yes | Yes | Yes | Yes |\n| Global search | Yes | Yes | Yes | Yes |\n| States & cities | No | Yes | Yes | Yes |\n| Live currency rates | No | Yes | Yes | Yes |\n| IP geolocation | No | Yes | Yes | Yes |\n| Monthly requests | 1,000 | 15,000 | 100,000 | 500,000 |\n\nUpgrade at [app.apogeoapi.com/dashboard/billing](https://app.apogeoapi.com/dashboard/billing).\n\n## Environment variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `APOGEOAPI_KEY` | Yes | Your API key from the dashboard |\n| `APOGEOAPI_BASE_URL` | No | Override the API base URL (default: `https://api.apogeoapi.com`) |\n\n## License\n\nMIT\n",
  "bytes": 3494,
  "sha": "6b49798d1c0759d86004cfe6140c08ead2d1a36d4d65242932dd90265ca86281",
  "repo_slug": "apogeoapi/apogeoapi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_apogeoapi_apogeoapi_mcp_0a401c74/readme"
}