Skip to main content
Glama
Sign In
DoubleData MCP

DoubleData MCP

by doubledata-proxy
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

DoubleData Proxy for AI agents

MCP server and agent skills for DoubleData Proxy. Your agent can manage the whole account and use the proxy network:

  • "How much do I have left? What did I use this month?": balance, bandwidth, requests and spend, totals and per credential.

  • "Make a proxy for my scraper, capped at 5 GB a month.": create, list, limit and delete residential, datacenter and mobile credentials.

  • "Open this page from a German residential IP.": fetch any URL through the network with country, city and sticky-session targeting. HTML comes back as Markdown.

  • "Give me 500 US sticky proxies for Playwright.": proxy lists and ready-to-paste connection snippets.

  • "Download all invoices since January for my accountant.": invoice PDFs plus a CSV index.

  • "Buy 10 private US ISP IPs" / "rotate these two IPs": Static ISP proxies from quote to rotation.

Everything you ask for can also be saved as a file (CSV, JSON, PDF, proxy lists) in a local export directory.

Quick start

  1. Get an API key. Run this in a terminal:

    npx -y github:doubledata-proxy/doubledata-mcp login

    It opens Dashboard › Team, where an organization admin creates the key. Paste the key at the hidden prompt. It is checked against the API and saved to ~/.config/doubledata/credentials.json with mode 600. You can also set DOUBLEDATA_API_KEY instead.

  2. Add the server to your agent (below).

  3. Ask: "Give me an overview of my DoubleData account."

Related MCP server: atheris-mcp

Install

The server runs over stdio and needs Node.js 20.18 or later.

Claude Code: plugin (MCP server and skills)

claude plugin marketplace add doubledata-proxy/doubledata-mcp
claude plugin install doubledata@doubledata

To install only the MCP server:

claude mcp add doubledata -- npx -y github:doubledata-proxy/doubledata-mcp

Codex

codex mcp add doubledata -- npx -y github:doubledata-proxy/doubledata-mcp

Cursor (~/.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), Windsurf

{
  "mcpServers": {
    "doubledata": {
      "command": "npx",
      "args": ["-y", "github:doubledata-proxy/doubledata-mcp"]
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "doubledata": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:doubledata-proxy/doubledata-mcp"]
    }
  }
}

GUI apps such as Claude Desktop may not see a key stored by login if they run with a different home directory. In that case add "env": { "DOUBLEDATA_API_KEY": "dd_live_..." } to the server entry.

Skills for other agents

The skills/ folder holds standard SKILL.md agent skills: doubledata-proxy for account, billing and credentials, and web-through-proxy for fetching through the network. Copy them into your agent's skills directory, for example ~/.claude/skills/ or .agents/skills/. They also cover agents that use the REST API without MCP.

Tools

Toolset

Tools

account

account_overview, get_balance, get_usage, export_usage

credentials

list_credentials, get_credential, create_credential, delete_credential, get_traffic_limits, set_traffic_limits

proxy

proxy_request, check_exit_ip, build_proxy_config, export_proxy_list

invoices

list_invoices, get_invoice, download_invoice, download_all_invoices

isp

isp_catalog, isp_quote, isp_order, isp_order_status, isp_subscriptions, isp_proxies, isp_rotate, isp_rotation_status, isp_get_ip_authorization, isp_set_ip_authorization, isp_cancel_renewal

There is also a proxy-guide resource (gateways, ports and targeting syntax) and two prompts, account_report and fetch_from_country.

Configuration

Variable

Default

Purpose

DOUBLEDATA_API_KEY

key saved by login

Organization API key

DOUBLEDATA_TOOLSETS

all

Comma list to expose, e.g. account,invoices

DOUBLEDATA_READ_ONLY

false

true hides every tool that spends money or traffic or changes the account

DOUBLEDATA_OUTPUT_DIR

./doubledata-exports

Where reports, PDFs and proxy lists are written. Writes outside it are refused.

DOUBLEDATA_PROXY_USERNAME / DOUBLEDATA_PROXY_PASSWORD

first enabled credential

Default credential for proxy tools

DOUBLEDATA_MAX_RESPONSE_CHARS

40000

How much of a fetched page is returned to the model

CLI commands: doubledata-mcp login, logout, whoami, --help.

Safety by design

  • Confirmation for consequential actions. isp_order requires confirm_purchase: true. delete_credential and isp_cancel_renewal require repeating the identifier. Each tool carries MCP readOnlyHint and destructiveHint annotations, so clients can ask before running them.

  • Read-only mode for dashboards and analysts.

  • Secrets stay out of chat. Passwords are masked unless you ask. Snippets use $DOUBLEDATA_PROXY_PASSWORD. Files that contain passwords are written with mode 600. The API key goes in a header, never in a URL.

  • Prompt-injection hygiene. Fetched pages are wrapped as untrusted content, and redirects are returned rather than followed.

  • Spend control. Give an agent its own credential with set_traffic_limits.

How it compares

DoubleData MCP

Bright Data MCP

Webshare MCP

Fetch pages through residential IPs with country, city and session targeting

✅

✅ (via Web Unlocker zones)

—

Account usage, balance and spend

✅

—

✅

Create, limit and delete proxy credentials

✅

—

✅

Invoice list and PDF download

✅

—

—

Exports to files (CSV, JSON, PDF, proxy lists)

✅

—

—

Agent skills and plugin bundled

✅

—

—

Read-only mode and toolset filtering

✅

partial

—

API key kept out of URLs

✅

— (hosted URL token)

✅

Bright Data's MCP focuses on scraping products such as SERP, Web Unlocker and Scraping Browser. This server focuses on running your own proxy account end to end.

Development

npm install
npm run check
npm run inspect

npm run check runs typecheck, tests and build. npm run inspect opens the MCP Inspector against dist/index.js.

REST API reference: https://doubledata.mintlify.app/api-reference/introduction

License

MIT

Available Tools

29 tools
account_overviewAccount overviewA
Read-only

One-call summary of the DoubleData account: wallet balance, this month's bandwidth/requests/spend, top credentials by traffic, credential count, active ISP subscriptions and open invoices. Use first when the user asks what they have, how much they used, or how much is left.

Inputs: no named parameters.

build_proxy_configBuild proxy connection stringA
Read-only

Build a ready-to-use proxy URL or host:port:user:pass line with targeting, plus code snippets. By default the password is an environment-variable placeholder so secrets never land in code; set password_mode to 'plain' only when the user explicitly wants it.

Inputs: city, format, sticky, country, +7 more.

check_exit_ipCheck proxy exit IPA

Verify a proxy configuration by returning the exit IP, country, city and network seen by a public IP echo service. Use it to confirm targeting and sticky sessions work before a larger job.

Inputs: city, country, gateway, session, +4 more.

create_credentialCreate proxy credentialA

Create a new proxy credential (username/password) for residential, datacenter or mobile traffic. Requires wallet balance or package GB for that product. Returns connection details; the password is masked unless reveal_password is true.

Inputs: name (required), proxy_type, reveal_password.

delete_credentialDelete proxy credentialA
DestructiveIdempotent

Permanently delete a proxy credential. Anything using it stops working immediately. Set confirm_username to the same username to proceed.

Inputs: username (required), confirm_username (required).

download_all_invoicesDownload all invoicesB
Idempotent

Download every invoice PDF (optionally filtered by status or a since date) into invoices/ in the export directory, plus an invoices.csv index. Use for bookkeeping and accounting exports.

Inputs: since, status, max_invoices.

download_invoiceDownload invoice PDFB
Idempotent

Save an invoice PDF into the local export directory and return the file path.

Inputs: invoice_id (required), path.

export_proxy_listExport proxy list fileA
Read-only

Write a proxy list file (one proxy per line) for scrapers and tools: N sticky sessions with unique IDs or rotating lines, in the chosen format. The file contains the real password and is created with owner-only permissions.

Inputs: city, path, count, format, +8 more.

export_usageExport usage reportA
Idempotent

Download a per-credential usage report as CSV or JSON into the local export directory. Use when the user wants a file, spreadsheet or report of their traffic.

Inputs: to, from, path, format, +1 more.

get_balanceGet wallet balanceA
Read-only

Return the organization's prepaid wallet balance in USD cents. Package GB balances are reflected in usage and credential funding.

Inputs: no named parameters.

get_credentialGet proxy credentialA
Read-only

Return one credential with gateway hosts and ports. The password is masked unless reveal_password is true; prefer proxy tools, which use the password without showing it.

Inputs: username (required), reveal_password.

get_invoiceGet invoiceA
Read-only

Return one invoice by ID with totals, status, dates and hosted invoice link.

Inputs: invoice_id (required).

get_traffic_limitsGet traffic limitsB
Read-only

Show a credential's total, daily, weekly and monthly traffic limits in MB and current consumption.

Inputs: username (required).

get_usageGet bandwidth usageA
Read-only

Bandwidth bytes, request counts and wallet charges for a UTC date range, in total and per credential. Defaults to the current month. Use username to focus on one credential.

Inputs: to, from, username.

isp_cancel_renewalCancel ISP renewalA
DestructiveIdempotent

Stop an ISP subscription from renewing. Proxies keep working until the current period ends. Set confirm_subscription_id to the same ID to proceed.

Inputs: subscription_id (required), confirm_subscription_id (required).

isp_catalogISP proxy catalogA
Read-only

Show ISP (static residential) proxy tiers, available countries with stock, add-on features and prices.

Inputs: no named parameters.

isp_get_ip_authorizationGet ISP IP authorizationB
Read-only

Show which public IPv4 address may use the subscription's proxies without a password.

Inputs: subscription_id (required).

isp_orderBuy ISP proxiesA
Destructive

Purchase a quoted ISP package. This charges the wallet. Only call after the user explicitly approved the quoted price; set confirm_purchase to true. Poll isp_order_status until the order completes.

Inputs: quote_id (required), confirm_purchase (required).

isp_order_statusISP order statusB
Read-only

Check an ISP order's provisioning status and the resulting subscription.

Inputs: order_id (required).

isp_proxiesList ISP proxiesA
Read-only

List the static IPs of an ISP subscription. Passwords are masked unless reveal_passwords is true. Set export_format to save a proxy list file (owner-only permissions) instead.

Inputs: subscription_id (required), path, export_format, reveal_passwords.

isp_quoteQuote ISP proxiesA

Price an ISP proxy package without buying it. Returns a quote_id valid for a short time and the total. Show the price to the user before calling isp_order.

Inputs: tier (required), countries (required), term, features, +2 more.

isp_rotateRotate ISP IPsA
Destructive

Replace specific ISP IPs with new ones. Uses the subscription's rotation allowance and the old IPs stop working. Poll isp_rotation_status with the returned rotation ID.

Inputs: ips (required), subscription_id (required).

isp_rotation_statusISP rotation statusB
Read-only

Check a rotation's progress and the replacement IPs.

Inputs: rotation_id (required).

isp_set_ip_authorizationSet ISP IP authorizationA
Idempotent

Allow one public IPv4 address to use the subscription's proxies without a password, or remove it with remove: true.

Inputs: subscription_id (required), ip, remove.

isp_subscriptionsList ISP subscriptionsA
Read-only

List active ISP subscriptions with countries, proxy count, renewal date, remaining rotations and IP authorization.

Inputs: no named parameters.

list_credentialsList proxy credentialsA
Read-only

List residential, datacenter and mobile proxy credentials (username, name, product, enabled, traffic used, limits). Passwords are not included; use get_credential.

Inputs: proxy_type.

list_invoicesList invoicesB
Read-only

List the organization's invoices newest first with number, status, totals, amount due and a hosted payment link. Paginate with starting_after (the next_cursor of the previous page).

Inputs: limit, status, starting_after.

proxy_requestSend HTTP request through proxyA

Fetch a URL through the DoubleData proxy network with optional country/city targeting and sticky sessions. Returns status, key headers and the body (HTML converted to Markdown by default, truncated to a safe size). Use save_to to download the raw response to a file. Consumes proxy traffic.

Inputs: url (required), body, city, method, +12 more.

set_traffic_limitsSet traffic limitsA
Idempotent

Cap how much traffic a credential may use. Values are MB; 0 removes that limit. Only the provided limits change. Useful to give an agent or teammate a bounded budget.

Inputs: username (required), daily_mb, total_mb, weekly_mb, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.6/5.0

    Scored across 29 tools

    Disambiguation4/5

    The tools are grouped into clear domains (account/usage, credentials, proxy operations, invoices, ISP subscriptions), and most actions are distinct. A few pairs could still be confused at a glance, such as account_overview vs. get_balance/get_usage, get_credential vs. build_proxy_config/export_proxy_list, and isp_proxies vs. export_proxy_list, but the descriptions largely resolve this.

    Naming Consistency4/5

    The server uses snake_case consistently and mostly follows a verb_noun pattern (e.g., get_usage, create_credential, download_invoice). The ISP tools are prefixed by domain and sometimes use noun-first naming (isp_catalog, isp_proxies), and a few others are noun-first (account_overview, proxy_request), but the convention remains readable and predictable.

    Tool Count3/5

    At 29 tools, the surface is heavy for an MCP server and increases agent selection burden. The breadth is partly justified by the multiple domains covered (account, usage, credentials, proxy building, invoices, ISP), but it sits at the upper edge of what is comfortably scoped.

    Completeness4/5

    Core workflows are well covered: usage reporting/export, credential lifecycle, proxy request/config/export, invoice listing and PDF downloads, and ISP quote/order/status/rotation/authorization/cancellation. Minor gaps exist, such as updating credential metadata/passwords and invoice payment/management beyond hosted links, but most agent tasks can be completed.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • atheris-mcp

      atheris-ee
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables agents to autonomously route traffic through real 4G/5G mobile and residential IPs by country, with tools to check live proxy stock, obtain ready-to-use proxy URLs, and monitor remaining data usage.
      53 npm
      MIT

    • proxy

      profullstack
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables fetching web URLs through authenticated residential egress with provider, country, and session controls. It also exposes tools for checking the exit IP, account status, and masked connection URL.
      29 npm
      MIT