Каталог MCP
APOGEOAPI/apogeoapi-mcp

APOGEOAPI/apogeoapi-mcp

Name: APOGEOAPI/apogeoapi-mcp
Availability: InStock
Author: apogeoapi

MCP сервер для доступа к ApogeoAPI: геоданные, курсы валют и IP-геолокация. Он позволяет ИИ-ассистентам получать актуальные данные о странах, городах и валютах прямо из диалога. Бесплатный тариф: 1000 запросов в месяц.

Github NPM Сайт сервера

README

8 инструментов

Версии

Установить сервер

@apogeoapi/mcp

MCP (Model Context Protocol) server for ApogeoAPI — geographic data, live exchange rates, and IP geolocation for Claude Desktop, Cursor, and any MCP-compatible AI assistant.

What it does

This 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.

Available tools

Tool	Description	Plan required
`get_country`	Full country data by ISO2/ISO3 code — name, capital, region, population, currency, timezones, phone code (plus the live USD rate on Basic+)	Free
`list_countries`	Paginated list of all 250+ countries	Free
`search_countries`	Search countries by partial name	Free
`get_states`	All states/provinces for a country	Free
`get_cities`	All cities for a state by numeric state ID	Basic+
`get_currency_rate`	Live USD exchange rate for a country's currency (updated every 4 hours)	Basic+
`geolocate_ip`	Country, region, city, coordinates, timezone, and EU membership for any IPv4/IPv6	Basic+
`global_search`	Search across countries, states, and cities in one query	Basic+

Инструменты были проиндексированы: 21.10.2026

geolocate_ip

Геолоцирует IPv4 или IPv6 адрес: возвращает страну, регион, город, координаты, часовой пояс и принадлежность к ЕС. Требуется тариф Starter или выше.

Параметры

addressstringобязательный
IPv4- или IPv6-адрес для геолокации (например, 8.8.8.8 или 2001:4860:4860::8888)

get_cities

Получает все города для региона или провинции по идентификатору региона. Требует тарифный план Starter или выше.

Параметры

fieldsenum
limitinteger
pageinteger
state_idintegerобязательный
Числовой идентификатор состояния (из ответа get_states)

get_country

Получает полные данные о стране по коду ISO2 или ISO3 — включает название, столицу, регион, население, валюту, актуальный курс к доллару США, часовые пояса и телефонный код.

Параметры

codestringобязательный
Код страны ISO2 (например, AR) или ISO3 (например, ARG)
fieldsenum
Уровень детализации: базовый (быстрый), стандартный (по умолчанию), полный (все поля).

get_currency_rate

Получает актуальный курс USD к валюте страны. Обновляется каждые 4 часа. Требуется тариф Starter или выше.

Параметры

country_codestringобязательный
Код страны ISO2 или ISO3 (например, AR, BR, JP)

get_states

Получить все штаты/провинции для страны. Требуется тарифный план Starter или выше.

Параметры

country_codestringобязательный
Код страны ISO2 или ISO3
fieldsenum
limitinteger
pageinteger

global_search

Ищет по странам, штатам и городам одним запросом. Возвращает лучшие совпадения среди всех типов географических объектов.

Параметры

limitinteger
Максимум результатов, по умолчанию 100.
qstringобязательный
Поисковый запрос (например, "Буэнос-Айрес", "Пампасы", "Кордова")

list_countries

Список всех стран с пагинацией. По умолчанию возвращает основную информацию: добавьте fields=full для всех данных.

Параметры

fieldsenum
Уровень детализации
limitinteger
Результатов на странице (по умолчанию: 10, макс.: 25)
pageinteger
Номер страницы, по умолчанию 1

search_countries

Ищет страны по названию (например, "arg" находит Аргентину). Возвращает постраничные результаты.

Параметры

limitinteger
pageinteger
qstringобязательный
Поисковый запрос (частичное совпадение по имени)

`1.0.2`основная	11.05.2026
`1.0.1`	04.04.2026
`1.0.0`	16.03.2026

Выберите клиент, чтобы установить APOGEOAPI/apogeoapi-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "apogeoapi-apogeoapi-mcp-uxdszmp349": {
      "command": "npx",
      "args": [
        "-y",
        "@apogeoapi/mcp"
      ],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "apogeoapi-apogeoapi-mcp-uxdszmp349": {
      "command": "npx",
      "args": [
        "-y",
        "@apogeoapi/mcp"
      ],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "apogeoapi-apogeoapi-mcp-uxdszmp349": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@apogeoapi/mcp"
      ],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"apogeoapi-apogeoapi-mcp-uxdszmp349\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@apogeoapi/mcp\"],\"env\":{\"APOGEOAPI_KEY\":\"apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "apogeoapi-apogeoapi-mcp-uxdszmp349": {
      "command": "npx",
      "args": [
        "-y",
        "@apogeoapi/mcp"
      ],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add apogeoapi-apogeoapi-mcp-uxdszmp349 --env APOGEOAPI_KEY=apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -- npx -y @apogeoapi/mcp

Либо через JSON-конфиг:

claude mcp add-json apogeoapi-apogeoapi-mcp-uxdszmp349 "{\"command\":\"npx\",\"args\":[\"-y\",\"@apogeoapi/mcp\"],\"env\":{\"APOGEOAPI_KEY\":\"apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add apogeoapi-apogeoapi-mcp-uxdszmp349 --env APOGEOAPI_KEY=apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -- npx -y @apogeoapi/mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.apogeoapi-apogeoapi-mcp-uxdszmp349]
command = "npx"
args = ["-y", "@apogeoapi/mcp"]

[mcp_servers.apogeoapi-apogeoapi-mcp-uxdszmp349.env]
APOGEOAPI_KEY = "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите APOGEOAPI/apogeoapi-mcp, а в поле команды запуска — строку ниже:

npx -y @apogeoapi/mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "apogeoapi-apogeoapi-mcp-uxdszmp349": {
      "command": "npx",
      "args": [
        "-y",
        "@apogeoapi/mcp"
      ],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "apogeoapi-apogeoapi-mcp-uxdszmp349": {
      "command": "npx",
      "args": [
        "-y",
        "@apogeoapi/mcp"
      ],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например apogeoapi-apogeoapi-mcp-uxdszmp349.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: apogeoapi-apogeoapi-mcp-uxdszmp349
    command: npx
    args:
      - "-y"
      - "@apogeoapi/mcp"
    env:
      APOGEOAPI_KEY: apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "apogeoapi-apogeoapi-mcp-uxdszmp349": {
      "command": "npx",
      "args": [
        "-y",
        "@apogeoapi/mcp"
      ],
      "env": {
        "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@apogeoapi/mcp"
  ],
  "env": {
    "APOGEOAPI_KEY": "apogeoapi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx