{"_id":"@1001proxy-mcp/server","_rev":"3-1c5374bbb22f9deda2f16dd0259a4d8f","name":"@1001proxy-mcp/server","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@1001proxy-mcp/server","version":"1.0.0","keywords":["mcp","model-context-protocol","proxy","ai-agent","claude","1001proxy","residential-proxy","datacenter-proxy"],"license":"MIT","_id":"@1001proxy-mcp/server@1.0.0","maintainers":[{"name":"1001proxy-mcp","email":"npmjs@1001proxy.io"}],"homepage":"https://1001proxy.com/docs/mcp","bugs":{"url":"https://github.com/1001proxy/mcp-server/issues"},"bin":{"1001proxy-mcp":"dist/index.js"},"dist":{"shasum":"5eb4819b8dfcfc36bc572c86fe0011a421f4d9c6","tarball":"https://registry.npmjs.org/@1001proxy-mcp/server/-/server-1.0.0.tgz","fileCount":6,"integrity":"sha512-PBIyjMSmKsOkBkaA++69qiE2X0zJxtxMKoZU9xjNwyjqywdFXLU7/9a4se9h7iAxCFrbxpdpUwtzak+Pgf6spw==","signatures":[{"sig":"MEUCIHeYlEE/+ST5ditSolgU9X4orlBnBawP29SFQM8sQy/yAiEA9uY1xUrzl6S7jmTWoIrPN3w1k+dTmrByi8P9dC/fa1Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36979},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"ac74079832f7c81a222e073f67203454d46e668f","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"1001proxy-mcp","email":"npmjs@1001proxy.io"},"repository":{"url":"git+https://github.com/1001proxy/mcp-server.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server for 1001Proxy — let AI agents buy and manage proxies","directories":{},"_nodeVersion":"22.18.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22"},"_npmOperationalInternal":{"tmp":"tmp/server_1.0.0_1775490262808_0.11142466369294435","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@1001proxy-mcp/server","version":"1.0.1","keywords":["mcp","model-context-protocol","proxy","ai-agent","claude","1001proxy","residential-proxy","datacenter-proxy"],"license":"MIT","_id":"@1001proxy-mcp/server@1.0.1","maintainers":[{"name":"1001proxy-mcp","email":"npmjs@1001proxy.io"}],"homepage":"https://1001proxy.com/docs/mcp","bugs":{"url":"https://github.com/1001proxy/mcp-server/issues"},"bin":{"1001proxy-mcp":"dist/index.js"},"dist":{"shasum":"3563dace10491db0b105f35d5d72c8ab98c7dd6f","tarball":"https://registry.npmjs.org/@1001proxy-mcp/server/-/server-1.0.1.tgz","fileCount":6,"integrity":"sha512-cmYJqseeclzH9Dh3dlpla7PVRDnWUadeDzmtQb2ED2Ku6eFp3eIq5048G7B6t1OgcaM9f1IUUJzC2JkhqMJhqw==","signatures":[{"sig":"MEUCIG98xr5/fRNsc1lmdIl1JXWFgWbx+l0jKaScMDpA7HF3AiEAqgbWvm38gZcbeCgPxvhFV4KOJztueJkb1uWZqflu4CI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36974},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"ac74079832f7c81a222e073f67203454d46e668f","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"1001proxy-mcp","email":"npmjs@1001proxy.io"},"repository":{"url":"git+https://github.com/1001proxy/mcp-server.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server for 1001Proxy — let AI agents buy and manage proxies","directories":{},"_nodeVersion":"22.18.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22"},"_npmOperationalInternal":{"tmp":"tmp/server_1.0.1_1775490457704_0.9201523167737065","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@1001proxy-mcp/server","version":"1.0.2","description":"MCP server for 1001Proxy — let AI agents buy and manage proxies","type":"module","main":"dist/index.js","bin":{"1001proxy-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","proxy","ai-agent","claude","1001proxy","residential-proxy","datacenter-proxy"],"homepage":"https://www.1001proxy.io/docs/mcp","repository":{"type":"git","url":"git+https://github.com/1001proxy/mcp-server.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"devDependencies":{"typescript":"^5.7.0","@types/node":"^22"},"engines":{"node":">=18"},"license":"MIT","gitHead":"ac74079832f7c81a222e073f67203454d46e668f","types":"./dist/index.d.ts","_id":"@1001proxy-mcp/server@1.0.2","bugs":{"url":"https://github.com/1001proxy/mcp-server/issues"},"_nodeVersion":"22.18.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-utVKZaeAdzsHgxs6/JHuAJgiogbiicw143rOkXy94l3SxkCmTiXNJcypFCOeO2ENKQxJULAUNJIkc9im54a5HQ==","shasum":"54e36b4a74a66fd057e8c1a41a38249438236054","tarball":"https://registry.npmjs.org/@1001proxy-mcp/server/-/server-1.0.2.tgz","fileCount":6,"unpackedSize":36977,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIClxRdrvnt/34i5Y0Hmxspn+BuUNK/xXmZT3jXj8I6chAiBmCQvG6PiAPBt0eGAiaHEFLcl6cK7quAM48MtugOy1tQ=="}]},"_npmUser":{"name":"1001proxy-mcp","email":"npmjs@1001proxy.io"},"directories":{},"maintainers":[{"name":"1001proxy-mcp","email":"npmjs@1001proxy.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/server_1.0.2_1775490569696_0.8873352062996567"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-06T15:44:22.696Z","modified":"2026-04-06T15:49:30.009Z","1.0.0":"2026-04-06T15:44:22.955Z","1.0.1":"2026-04-06T15:47:37.861Z","1.0.2":"2026-04-06T15:49:29.883Z"},"bugs":{"url":"https://github.com/1001proxy/mcp-server/issues"},"license":"MIT","homepage":"https://www.1001proxy.io/docs/mcp","keywords":["mcp","model-context-protocol","proxy","ai-agent","claude","1001proxy","residential-proxy","datacenter-proxy"],"repository":{"type":"git","url":"git+https://github.com/1001proxy/mcp-server.git"},"description":"MCP server for 1001Proxy — let AI agents buy and manage proxies","maintainers":[{"name":"1001proxy-mcp","email":"npmjs@1001proxy.io"}],"readme":"# 1001Proxy MCP Server\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that lets AI agents (Claude, GPT-4o, etc.) purchase and manage proxies from [1001Proxy](https://1001proxy.io) directly within a conversation.\n\n---\n\n## Setup\n\n### 1. Get your API key\n\nLog in to [1001proxy.io](https://1001proxy.io), go to **Account**, and copy your API key.\n\n### 2. Install and build\n\n```bash\ncd mcp-server\nnpm install\nnpm run build\n```\n\n### 3. Environment variables\n\n| Variable        | Required | Default                  | Description                        |\n|-----------------|----------|--------------------------|------------------------------------|\n| `PROXY_API_KEY` | Yes      | —                        | Your 1001Proxy API key             |\n| `PROXY_API_URL` | No       | `https://1001proxy.io`  | Override for self-hosted instances |\n\n---\n\n## Usage with Claude Desktop\n\nAdd the following to your `claude_desktop_config.json` (usually at `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `%APPDATA%\\Claude\\claude_desktop_config.json` on Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"1001proxy\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/1001proxy/mcp-server/dist/index.js\"],\n      \"env\": {\n        \"PROXY_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving. You should see the 1001proxy tools available in the tool picker.\n\n---\n\n## Usage with other MCP clients\n\nThe server speaks the MCP stdio transport protocol — launch it as a subprocess with `PROXY_API_KEY` in its environment:\n\n```bash\nPROXY_API_KEY=your-key node mcp-server/dist/index.js\n```\n\nAny MCP-compatible client (Cursor, Zed, custom agents) can connect using stdio transport.\n\n---\n\n## Available tools\n\n| Tool                   | Description                                                                 |\n|------------------------|-----------------------------------------------------------------------------|\n| `get_account`          | Check account info and current prepaid balance in USD                       |\n| `list_proxy_types`     | Browse available proxy types with pricing guidance                          |\n| `get_reference_data`   | Fetch countries, periods, tariffs, and operator IDs for a proxy type        |\n| `calculate_order`      | Get a price quote for an order without placing it                           |\n| `create_order`         | Place an order and debit balance; supports idempotency keys                 |\n| `list_orders`          | List orders with optional pagination, status, and type filters              |\n| `get_order`            | Get full details for a single order by ID                                   |\n| `get_proxies`          | Retrieve structured proxy credentials (IP, port, login, password)           |\n| `download_proxies`     | Download proxy list as plain text (txt or csv)                              |\n| `extend_order`         | Renew an existing order for an additional period                            |\n| `get_transactions`     | View balance transaction history (deposits, purchases, refunds)             |\n| `get_deposit_addresses`| Get crypto deposit addresses to top up balance                              |\n\n---\n\n## Example workflow\n\nBelow is a typical end-to-end session an AI agent would follow:\n\n### 1. Check balance\n```\nget_account\n→ { balance: \"25.00\", email: \"you@example.com\", ... }\n```\n\n### 2. Browse proxy types\n```\nlist_proxy_types\n→ [ { type: \"ipv4\", indicativePrice: \"$0.30/IP\", ... }, ... ]\n```\n\n### 3. Get reference data for the chosen type\n```\nget_reference_data { type: \"ipv4\" }\n→ { countries: [...], periods: [...], tarifs: [...] }\n  // Note countryId for US, periodId for 30 days\n```\n\n### 4. Calculate price before committing\n```\ncalculate_order { type: \"ipv4\", countryId: 5, periodId: 3, quantity: 5, protocol: \"https\" }\n→ { price: 1.50, currency: \"USD\", quantity: 5 }\n```\n\n### 5. Place the order\n```\ncreate_order {\n  type: \"ipv4\",\n  countryId: 5,\n  periodId: 3,\n  quantity: 5,\n  protocol: \"https\",\n  idempotency_key: \"550e8400-e29b-41d4-a716-446655440000\"\n}\n→ { ok: true, orderId: \"clxyz...\", charged: 1.50 }\n```\n\n### 6. Download proxies\n```\ndownload_proxies { order_id: \"clxyz...\" }\n→ \"1.2.3.4:10000\\n5.6.7.8:10001\\n...\"\n```\n\n---\n\n## Proxy types quick reference\n\n| Type         | Best for                                          | Billed by  |\n|--------------|---------------------------------------------------|------------|\n| `residential`| Scraping, geo-bypass, ad verification             | GB         |\n| `ipv4`       | Automation, high-throughput tasks                 | IP/period  |\n| `ipv6`       | Mass requests on IPv6-compatible targets          | IP/period  |\n| `isp`        | Social media, e-commerce, long-running sessions   | IP/period  |\n| `mobile`     | Platforms with aggressive anti-bot measures       | IP/period  |\n\nUse `get_reference_data` with `resident` (not `residential`) when fetching reference data for residential proxies.\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}