MCP server ProxyCove
Коммит 14 сент. 2026 г.Позволяет ИИ-агентам покупать и управлять резидентными, мобильными и датацентрными прокси в более чем 170 странах, используя предоплаченный трафик в ГБ.
Также известен как proxycove/mcp-server, mcp-server
- Звёзды
- 0
- Инструменты
- 14
- Загрузки, 30 дней
- —
- Последняя версия
- 1.0.0
- Последний коммит
- 14 сент. 2026 г.
- Лицензия
- MIT
Что такое ProxyCove MCP?
Позволяет ИИ-агентам покупать и управлять резидентными, мобильными и датацентрными прокси в более чем 170 странах, используя предоплаченный трафик в ГБ. Он предоставляет 14 инструментов, например get_pricing, list_locations, create_account.
Сводка сгенерирована из README проекта
О ProxyCove MCP server
ProxyCove предоставляет удаленный MCP server, который позволяет ИИ-агентам покупать и управлять резидентными, мобильными и датацентрными прокси в более чем 170 странах. Этот сервер разработан для разработчиков, создающих агентов для автоматизации, скрапинга или тестирования, и позволяет агенту полностью контролировать жизненный цикл управления прокси. Агент может самостоятельно инициализироваться, вызывая create_account для получения API key, проверять цены через get_pricing и просматривать список доступных локаций.
Для обеспечения безопасности агент никогда не работает с конфиденциальными платежными данными. Вместо этого он использует create_topup для генерации платежной ссылки, которую пользователь затем открывает для оплаты банковской картой, криптовалютой или другими способами. Как только баланс пополнен, агент может использовать buy_proxy для получения учетных данных подключения. Сервер не сохраняет состояние (stateless) и использует streamable HTTP, что делает его совместимым с такими клиентами, как Claude Desktop, Cursor и ChatGPT. Пользователи могут подключаться к публичному удаленному эндпоинту или развернуть Node-сервер локально с помощью Docker или npm.
Что вы можете с ним делать
- 1Управление динамической ротацией IPРазработчик может дать агенту команду переключаться между использованием нового IP на каждый запрос и использованием сессий с закрепленным IP (sticky sessions).
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить ProxyCove MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка ProxyCove MCP в Claude Code
$ claude mcp add --transport http mcp-server https://mcp.proxycove.com/mcpУстановка ProxyCove MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.proxycove.com/mcp"
}
}
}Установка ProxyCove MCP в VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.proxycove.com/mcp"
}
}
}Установка ProxyCove MCP в VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"http","url":"https://mcp.proxycove.com/mcp"}'Установка ProxyCove MCP в Codex
$ codex mcp add mcp-server --url https://mcp.proxycove.com/mcpУстановка ProxyCove MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] url = "https://mcp.proxycove.com/mcp"
Установка ProxyCove MCP в Gemini CLI
$ gemini mcp add -s user --transport http mcp-server https://mcp.proxycove.com/mcpУстановка ProxyCove MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.proxycove.com/mcp",
"type": "http"
}
}
}Инструменты ProxyCove MCP 14
Определено из READMEget_pricinglist_locationscreate_accountget_accountcreate_topupget_payment_statusbuy_proxylist_proxiesget_credentialsextend_proxyget_usageset_rotation
| get_pricing | — | |
| list_locations | — | |
| create_account | — | |
| get_account | — | |
| create_topup | — | |
| get_payment_status | — | |
| buy_proxy | — | |
| list_proxies | — | |
| get_credentials | — | |
| extend_proxy | — | |
| get_usage | — | |
| set_rotation | — |
Показать все 14 инструментовПоказать меньше инструментов
link_telegramattach_recovery
| link_telegram | — | |
| attach_recovery | — |
Конфигурация
BACKEND_BASE_URLMCP_PORTMCP_SECRET_PATHPROXYCOVE_API_KEY
| Название | Описание | Тип |
|---|---|---|
| BACKEND_BASE_URL | — | |
| MCP_PORT | — | |
| MCP_SECRET_PATH | — | |
| PROXYCOVE_API_KEY | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийproxycove/mcp-server is public and reachablegithub.com/proxycove/mcp-server ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-09-14github.com/proxycove/mcp-server ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели14 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыNo tool named like delete, drop or execПройдено
- Удалённая конечная точка отвечает на рукопожатие MCPinitialize answered with protocol 2025-06-18 in 431 msПройдено
README
Открыть на GitHubProxyCove MCP Server
Let an AI agent buy and manage real proxies — no signup, no dashboard, no card details in the chat.
ProxyCove sells residential, mobile and datacenter proxies prepaid per GB across 170+ countries. This MCP server exposes that as 14 tools, so an agent can create its own account, hand the human a payment link, buy a proxy and get working connection credentials — all inside one conversation.
https://mcp.proxycove.com/mcp ← remote endpoint (streamable HTTP)
Status: live. The endpoint above is public — connect and use it. Anonymous calls are allowed for
get_pricing,list_locationsandcreate_account; everything else needs a key. Clients that prefer OAuth 2.1 can discover it at/.well-known/oauth-protected-resource.
Who it's for: developers building scraping / automation / testing agents, anyone whose agent needs an exit IP in a specific country, and MCP clients that want a proxy provider they can call directly instead of wrapping a REST API by hand.
What an agent can do end to end
create_account→ gets an API key (pc_live_...). No registration form, no email required.create_topup→ gets apayment_url. The human pays in the browser (SBP, bank card, crypto).buy_proxy→ getshttp://login:password@go.proxycove.com:824and starts using it.
Prices: residential $2.7/GB · mobile $3.8/GB · datacenter $1.5/GB. Traffic is prepaid and does not expire while the account is active.
Quick start
The server is remote — nothing to install. Add the endpoint to your client and (once you have a key) send it as a bearer token.
You can add the connector without a key: get_pricing, list_locations and create_account work unauthenticated. Run create_account, save the returned pc_live_... key, put it in the header, reconnect.
Claude Code
claude mcp add --transport http proxycove https://mcp.proxycove.com/mcp \
--header "Authorization: Bearer pc_live_YOUR_KEY"
Without a key yet (to call create_account first):
claude mcp add --transport http proxycove https://mcp.proxycove.com/mcp
Claude Desktop / Claude.ai (Connectors)
Settings → Connectors → Add custom connector
| Field | Value |
|---|---|
| Name | ProxyCove |
| Remote MCP server URL | https://mcp.proxycove.com/mcp |
Until OAuth ships, Claude Desktop can also reach the server through the stdio bridge, which is where the header lives:
{
"mcpServers": {
"proxycove": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.proxycove.com/mcp",
"--header", "Authorization: Bearer pc_live_YOUR_KEY"
]
}
}
}
ChatGPT (developer mode)
Settings → Connectors → Advanced → enable Developer mode, then Create:
| Field | Value |
|---|---|
| Name | ProxyCove |
| MCP server URL | https://mcp.proxycove.com/mcp |
| Authentication | Access token / API key → paste pc_live_YOUR_KEY |
Cursor
~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
{
"mcpServers": {
"proxycove": {
"url": "https://mcp.proxycove.com/mcp",
"headers": {
"Authorization": "Bearer pc_live_YOUR_KEY"
}
}
}
}
Codex CLI
~/.codex/config.toml:
[mcp_servers.proxycove]
url = "https://mcp.proxycove.com/mcp"
bearer_token_env_var = "PROXYCOVE_API_KEY"
export PROXYCOVE_API_KEY=pc_live_YOUR_KEY
Any other MCP client
{
"mcpServers": {
"proxycove": {
"type": "http",
"url": "https://mcp.proxycove.com/mcp",
"headers": {
"Authorization": "Bearer pc_live_YOUR_KEY"
}
}
}
}
Transport is streamable HTTP, stateless — POST only, one JSON-RPC request per call, no SSE stream and no session id. GET/DELETE on the endpoint return 405.
Agent skill
Beyond the tool descriptions, this repo ships an agent skill that tells an agent which tool to reach for: how to pick a proxy type for a job, when a sticky session is required, what each error code actually means, and the rules that keep the human in control — never handle payment details, quote the price before spending, save the key.
npx skills add proxycove/mcp-server
Tools
| Tool | What it does | API key |
|---|---|---|
get_pricing |
Price per GB (USD) for residential / mobile / datacenter | no |
list_locations |
Countries available for a given proxy type | no |
create_account |
Creates an account with no signup form, returns a pc_live_... key |
no |
get_account |
Balance (USD), attached email, number of active proxies | yes |
create_topup |
Creates an invoice, returns payment_url for the human |
yes |
get_payment_status |
Invoice status: pending / paid / cancelled |
yes |
buy_proxy |
Buys a proxy from the balance, returns connection credentials | yes |
list_proxies |
All proxies with remaining traffic and credentials | yes |
get_credentials |
Connection string for one proxy | yes |
extend_proxy |
Adds prepaid GB to an existing proxy (credentials unchanged) | yes |
get_usage |
Live used / remaining traffic for one proxy | yes |
set_rotation |
Rotate every request ↔ sticky IP for 1–120 minutes | yes |
link_telegram |
Returns a code to link the account to the Telegram bot (second way back in if the key is lost) | yes |
attach_recovery |
Attaches an email so the human can log in on the website | yes |
Read-only tools carry readOnlyHint. No tool deletes anything — there is no destructive operation in this server, and no tool can move money out of the account.
Connection model
Every proxy is reachable at go.proxycove.com:
| Port | Behaviour |
|---|---|
824 |
New IP on every request |
10000 |
Sticky IP, held for the configured 1–120 minutes |
set_rotation switches a proxy between the two modes; the login and password stay the same.
After
buy_proxy, wait ~5 seconds before the first request. The country filter takes a moment to propagate upstream, and an immediate first request may exit from another country.
Authentication
- The account API key looks like
pc_live_...and is sent asAuthorization: Bearer pc_live_.... create_accountissues one. The three no-auth tools exist precisely so an agent can bootstrap: check prices, check countries, create the account — then the human stores the key in the connector config.- The MCP server holds no state of its own. It forwards your
Authorizationheader to the ProxyCove REST API and returns the JSON response. - Calling an authenticated tool without a key returns a structured
no_api_keyerror explaining what to do — not a crash. - OAuth 2.1 + PKCE is coming next, which will remove the manual header step for clients that support it. The bearer key will keep working.
Payments: the agent never touches card data
This is a hard boundary, enforced by the tool design:
create_topupreturns apayment_url. That is all the agent gets.- The agent gives the URL to the human, who opens it in their own browser and pays there.
- Methods:
sbp(Russian instant bank transfer),card_ru,card_international,crypto,crypto_cryptomus. Minimum top-up $1.50. - No tool accepts a card number, CVV, or any payment credential. There is no field for one anywhere in the schema.
- The agent then polls
get_payment_statusuntilpaidand continues.
Purchases (buy_proxy, extend_proxy) spend the prepaid balance only. An agent cannot spend money that the human has not already deposited.
Self-hosting / running locally
The server is a thin, stateless wrapper over the public ProxyCove REST API — roughly 200 lines of Node with no database, no cache and no persistence. Self-host it if you want to audit the traffic, pin a version, or run it inside your own network.
Requirements: Node 20+ (or Docker).
git clone https://github.com/proxycove/mcp-server.git
cd mcp-server
npm install
export BACKEND_BASE_URL=https://proxycove.com
export MCP_PORT=4010
export MCP_SECRET_PATH=/mcp
npm start
# → http://localhost:4010/mcp
Docker:
docker build -t proxycove-mcp .
docker run -d --name proxycove-mcp \
-p 4010:4010 \
-e BACKEND_BASE_URL=https://proxycove.com \
-e MCP_PORT=4010 \
-e MCP_SECRET_PATH=/mcp \
proxycove-mcp
Environment variables
| Variable | Default | Purpose |
|---|---|---|
MCP_PORT |
4010 |
Port the HTTP server listens on |
MCP_SECRET_PATH |
/mcp |
Path the MCP endpoint is mounted at |
BACKEND_BASE_URL |
http://backend:5000 |
Base URL of the ProxyCove API; use https://proxycove.com when self-hosting |
PUBLIC_API_INVITE_CODE |
(empty) | Optional invite code forwarded by create_account |
Configuration is entirely from env — there is no config file and no secret baked into the image.
GET /healthz returns { "ok": true, "service": "proxycove-mcp" }.
Point your client at your own instance the same way:
{
"mcpServers": {
"proxycove": {
"type": "http",
"url": "http://localhost:4010/mcp",
"headers": { "Authorization": "Bearer pc_live_YOUR_KEY" }
}
}
}
REST API (non-MCP integrations)
Everything the MCP server does is available directly over HTTP — same endpoints, same key:
- Base URL:
https://proxycove.com/api/v1 - OpenAPI spec:
https://proxycove.com/api/v1/openapi.json
curl https://proxycove.com/api/v1/pricing
curl https://proxycove.com/api/v1/account \
-H "Authorization: Bearer pc_live_YOUR_KEY"
Use this if you are writing a normal client, a LangChain/LlamaIndex tool, a CI job, or anything that is not an MCP host.
Security
- The API key is shown once, at
create_account. Save it immediately — ProxyCove cannot show it again. - A key can be revoked at any time from the account on proxycove.com or by writing to support. Revoking it kills agent access instantly; the balance and proxies stay.
- Run
attach_recoveryorlink_telegramearly. Without a recovery channel on the account, a lost key means a lost balance. - Treat
pc_live_...like a password: it is a spending credential. Never paste it into a shared chat, a public repo, or an issue on this tracker. - Prefer env-var indirection (
bearer_token_env_var,${VAR}substitution) over literal keys in config files that get committed. - Found a vulnerability, or something that lets an agent spend more than it should? Email support@proxycove.com — please do not open a public issue for security reports.
Contributing
Issues and pull requests are welcome — bug reports, client-config recipes for MCP hosts not covered above, and tool-description improvements especially. The tool schemas are the product surface here; if a description misled your agent, that is a bug worth filing.
License
MIT © ProxyCove
Website: proxycove.com · MCP endpoint: https://mcp.proxycove.com/mcp · REST API: https://proxycove.com/api/v1 · Support: support@proxycove.com
Вопросы о ProxyCove MCP
Как добавить ProxyCove MCP в Claude Code?
Выполните claude mcp add --transport http mcp-server https://mcp.proxycove.com/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить ProxyCove MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет ProxyCove MCP?
Он предоставляет 14 инструментов, включая get_pricing, list_locations, create_account, get_account, create_topup.
Что произойдет, если я потеряю свой API key?
Если вы не привязали резервный email или Telegram-бота, потеря ключа означает потерю доступа к балансу. Рекомендуется заранее использовать attach_recovery или link_telegram.
Истекает ли срок действия трафика прокси?
Нет, трафик предоплачен и остается действительным до тех пор, пока аккаунт активен.