{"name":"com.2extract/mcp","slug":"2extract-mcp","title":"2extract","description":"Create and manage residential and mobile proxies: geo targeting, usage limits, spend reports.","url":"https://mcp.market/server/2extract-mcp","rating":null,"grade":"A","score":91,"certified":false,"status":"active","category":"maps","tags":["maps"],"presence":{"score":26,"stars":1,"forks":0,"downloads_week":null,"last_push_at":"2026-10-23T12:16:07.000Z","license":"MIT"},"uptime":{"percent":100,"checks":28,"ok":28,"last_checked_at":"2026-11-04T06:55:39.500Z","last_ok_at":"2026-11-04T06:55:39.500Z","latency_ms":615},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/2extract/mcp","website":"https://mcp.2extract.com/","version":"1.0.2","remotes":[{"type":"streamable-http","url":"https://mcp.2extract.com/mcp","headers":[{"description":"2extract API key as a bearer token","isRequired":true,"value":"Bearer {api_key}","variables":{"api_key":{"description":"2extract API key (starts with 2xt_). Create one at https://2extract.com/app/api-keys","isRequired":true,"isSecret":true}},"name":"Authorization"}]}],"packages":[],"tools":[{"name":"buildConnectionString","description":"Build a ready-to-use username and connection string for a proxy resource. The tool retrieves the proxy credential and account prefix automatically, validates geo, network, and session parameters, and encodes them in the correct order. Returns the host, port, username, password, and a username:password@host:port connection string. Response fields: docs://proxies/buildConnectionString.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Proxy resource ID from listProxyResources."},"country_code":{"type":"string","description":"Optional two-letter ISO country code, e.g. US."},"state":{"type":"string","description":"Region extract_parameter. Requires country_code."},"city":{"type":"string","description":"City extract_parameter. Requires country_code and state."},"zip":{"type":"string","description":"ZIP value. Requires country_code; excludes state/city."},"asn":{"type":"integer","description":"Residential ASN. Excludes location and isp.","minimum":0},"isp":{"type":"integer","description":"Mobile ISP code. Excludes location and asn.","minimum":0},"session":{"type":"string","description":"Optional alphanumeric sticky-session ID."},"session_ttl_minutes":{"type":"integer","description":"TTL in minutes. Requires session."},"strict":{"type":"boolean","description":"Strict sticky session. Requires session."}},"required":["id"],"additionalProperties":false}},{"name":"createProxyResource","description":"Create a new residential or mobile proxy resource on the account. Check getAccountBalance and require can_create_proxy to be true; usage is billed according to the selected plan (tariff_id from listProxyPlans). The name must be unique on the account and cannot be changed later. Limits can be set here or later with setProxyLimits. Returns the complete new proxy, including its password. Use buildConnectionString to get a connection string. Response fields: docs://proxies/createProxyResource.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","description":"Proxy name: lowercase letters, digits, underscores only, max 50 characters. Immutable after creation."},"proxy_type":{"type":"string","description":"Proxy type, one of: residential, mobile"},"tariff_id":{"type":"integer","description":"Tariff plan ID from listProxyPlans","minimum":0},"countries":{"type":["null","array"],"items":{"type":"integer","minimum":0},"description":"Country IDs; empty allows any country."},"description":{"type":"string","description":"Free-text note, shown alongside this proxy in listProxyResources. Write enough detail to identify this proxy's purpose at a glance later — e.g. the project or task it's for, why it was created, its default country, or other distinguishing settings."},"ip_whitelist":{"type":["null","array"],"items":{"type":"string"},"description":"IP addresses allowed to authenticate with this proxy, e.g. ['203.0.113.1']. Empty or omitted means no IP restriction."},"limits":{"type":["null","object"],"properties":{"limit_type":{"type":"string","description":"'money' = USD spend cap, 'traffic' = bytes cap"},"time_period":{"type":"string","description":"Reset period for the limit counter, one of: daily, monthly"},"total_limit":{"type":"number","description":"Limit value: USD amount for 'money', bytes for 'traffic'"}},"description":"Optional spend or traffic limit. Can also be set later via setProxyLimits.","required":["limit_type","time_period","total_limit"],"additionalProperties":false}},"required":["name","proxy_type","tariff_id"],"additionalProperties":false}},{"name":"deactivateProxyResource","description":"Deactivate a proxy resource, stopping its traffic without deleting it. Reactivate later with updateProxyResource (status active). Use deleteProxyResource to permanently remove instead. Returns the updated proxy with status inactive. Response fields: docs://proxies/updateProxyResource (shared with updateProxyResource).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Proxy resource ID. Get from listProxyResources."}},"required":["id"],"additionalProperties":false}},{"name":"deleteProxyResource","description":"Permanently delete a proxy resource. This action is irreversible — the proxy and all its settings will be removed. User confirmation is required before proceeding. To stop traffic but keep the proxy for later, use deactivateProxyResource instead. Returns a snapshot of the deleted proxy with status deleted. Response fields: docs://proxies/deleteProxyResource.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Proxy resource ID. Get from listProxyResources."},"confirm":{"type":"boolean","description":"Set to true only after the user has explicitly confirmed the deletion. Skips the confirmation step."}},"required":["id"],"additionalProperties":false}},{"name":"getAccountBalance","description":"Get the current account balance, overdraft limit, and proxy username prefix. Returns funds_available in USD, can_create_proxy (whether proxy creation is allowed), and the prefix that starts every proxy username. Overdraft-enabled accounts also return credit_limit in USD and may return credit_limit_unlimited. Use can_create_proxy to check creation eligibility. For past deposits and charges, use listAccountBalanceHistory. Response fields: docs://account/getAccountBalance.","write_action":false,"price_micros":0,"input_schema":{"type":"object","additionalProperties":false}},{"name":"getAccountTrafficUsage","description":"Get daily traffic and spend for the account over a date range, broken down by proxy. Returns, for each date with traffic, the bytes downloaded and uploaded and the USD spent per proxy resource ID; dates with no traffic are omitted. Pass user_proxy_list_id to report on one proxy. For per-proxy totals over a period, listProxyResources with statistic_from/statistic_to is simpler. Results are paginated: keep requesting pages while meta.pagination.hasMorePages is true. Response fields: docs://account/getAccountTrafficUsage.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"date_from":{"type":"string","description":"Start date in YYYY-MM-DD format, e.g. 2024-01-01"},"date_to":{"type":"string","description":"End date in YYYY-MM-DD format, e.g. 2024-01-31"},"user_proxy_list_id":{"type":"string","description":"Filter to a single proxy resource ID, from listProxyResources. Omit to get all proxies."},"page":{"type":"integer","description":"One-based page number; omitted or 0 uses page 1"},"limit":{"type":"integer","description":"Items per page, default 100, max 200"}},"required":["date_from","date_to"],"additionalProperties":false}},{"name":"getProxyResource","description":"Get full details of a specific proxy resource, including IP/host whitelists not present in listProxyResources. Returns the proxy with its password, IP whitelist, and target host whitelist. Response fields: docs://proxies/getProxyResource.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Proxy resource ID, e.g. '86Rf07'. Get from listProxyResources."}},"required":["id"],"additionalProperties":false}},{"name":"listAccountBalanceHistory","description":"Get balance transaction history for the account over a date range. Returns paginated ledger entries (top-ups, debits, refunds) with signed USD amount, source, and timestamp. For the current balance, use getAccountBalance. Response fields: docs://account/listAccountBalanceHistory.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"date_from":{"type":"string","description":"Start date in YYYY-MM-DD format, e.g. 2024-01-01"},"date_to":{"type":"string","description":"End date in YYYY-MM-DD format, e.g. 2024-01-31"},"limit":{"type":"integer","description":"Items per page, default 100, max 200"},"page":{"type":"integer","description":"One-based page number; omitted or 0 uses page 1"},"order":{"type":"string","description":"Sort direction: asc or desc, default desc"}},"required":["date_from","date_to"],"additionalProperties":false}},{"name":"listGeoCountries","description":"List all available countries for proxy geo targeting, optionally filtered by name. Returns each country's numeric id (for createProxyResource countries) and ISO code (for buildConnectionString country_code). Response fields: docs://geo/listGeoCountries.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"search":{"type":"string","description":"Optional country name filter, minimum 2 characters, e.g. 'United'"}},"additionalProperties":false}},{"name":"listProxyPlans","description":"List tariff plans for a proxy type. Use the numeric id when calling createProxyResource. Returns each plan's id, title, price, currency, and traffic type (package or pay as you go). Response fields: docs://plans/listProxyPlans.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"proxy_type":{"type":"string","description":"Proxy type to list plans for, one of: residential, mobile"},"enabled":{"type":["null","boolean"],"description":"Filter by enabled status. Default: true (only purchasable plans). Pass false to see all plans including disabled."},"popular":{"type":["null","boolean"],"description":"Filter by popular flag. Omit to return all plans regardless of popularity."}},"required":["proxy_type"],"additionalProperties":false}},{"name":"listProxyResources","description":"List proxy resources in the account, with optional filters by name and status, and tariff, limits, traffic, and spend detail. Returns paginated proxies without passwords, plus totals for traffic and spend across the whole filtered set. Use getProxyResource for one proxy's password and whitelists. Response fields: docs://proxies/listProxyResources.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"search":{"type":"string","description":"Filter by proxy name (partial match, case-insensitive)"},"status":{"type":"string","description":"Filter by status: 'active', 'inactive', or comma-separated list e.g. 'active,inactive'"},"limit":{"type":"integer","description":"Items per page, default 100, max 200"},"page":{"type":"integer","description":"One-based page number; omitted or 0 uses page 1"},"order":{"type":"string","description":"Sort direction: asc or desc, default desc"},"order_by":{"type":"string","description":"Sort field: name, status, tariff.name, traffic_used.total_used, total_spent, created_at"},"statistic_from":{"type":"string","description":"Start date for per-proxy traffic statistics in YYYY-MM-DD format"},"statistic_to":{"type":"string","description":"End date for per-proxy traffic statistics in YYYY-MM-DD format"}},"additionalProperties":false}},{"name":"regenerateProxyPassword","description":"Generate a new password for a proxy resource. The old password is immediately invalidated — any running traffic using it will be interrupted. User confirmation is required before proceeding. Returns the complete proxy with the new password. Response fields: docs://proxies/regenerateProxyPassword.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Proxy resource ID. Get from listProxyResources."},"confirm":{"type":"boolean","description":"Set to true only after the user has explicitly confirmed the regeneration. Skips the confirmation step."}},"required":["id"],"additionalProperties":false}},{"name":"searchGeoCities","description":"Search cities within a country and optional region (region_code from searchGeoRegions). Use search to narrow results — city lists can be large. Returns each city's extract_parameter, the value for buildConnectionString's city. Response fields: docs://geo/searchGeoCities.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"country_code":{"type":"string","description":"ISO country code, e.g. 'US', 'DE'"},"region_code":{"type":"integer","description":"Numeric region code to filter cities, from searchGeoRegions' 'code' field, e.g. 77 for California"},"search":{"type":"string","description":"City name search, minimum 2 characters, e.g. 'Los'"}},"required":["country_code"],"additionalProperties":false}},{"name":"searchGeoISP","description":"Search the ISP catalog for mobile ISP targeting (mobile proxies only). Always resolve the code through this tool — never accept a real-world ASN number as a substitute. Returns each carrier's name and catalog code, the value for buildConnectionString's isp. Response fields: docs://geo/searchGeoISP.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"search":{"type":"string","description":"ISP name substring search, minimum 3 characters, e.g. 'AT&T'"},"limit":{"type":"integer","description":"Max results, default 100, max 500"}},"additionalProperties":false}},{"name":"searchGeoRegions","description":"Search regions/states within a country, identified by its ISO country_code (from listGeoCountries). Returns each region's extract_parameter, the value for buildConnectionString's state, and its numeric code, used as searchGeoCities' region_code. Response fields: docs://geo/searchGeoRegions.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"country_code":{"type":"string","description":"ISO country code, e.g. 'US', 'DE', 'GB'"},"search":{"type":"string","description":"Optional region name filter, minimum 3 characters, e.g. 'California'"}},"required":["country_code"],"additionalProperties":false}},{"name":"searchGeoZips","description":"Search ZIP codes within a country, for use in proxy username params. Returns ZIP values to pass as buildConnectionString's zip; ZIP targeting cannot be combined with state or city. Response fields: docs://geo/searchGeoZips.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"country_code":{"type":"string","description":"ISO country code, e.g. 'US', 'DE'"},"search":{"type":"string","description":"ZIP substring search, minimum 3 characters, e.g. '123'"},"limit":{"type":"integer","description":"Max results, default 100, max 500"}},"required":["country_code"],"additionalProperties":false}},{"name":"setProxyIpWhitelist","description":"Replace the IP whitelist for a proxy resource, restricting authentication to the given IPs. This controls who can authenticate; to control which domains the proxy can reach, use setProxyTargetHosts. Returns the updated proxy with the applied IP whitelist. Response fields: docs://proxy-settings/setProxyIpWhitelist.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Proxy resource ID. Get from listProxyResources."},"ips":{"type":["null","array"],"items":{"type":"string"},"description":"List of allowed IP addresses, e.g. ['203.0.113.1', '198.51.100.42']. Empty array removes all IP restrictions."}},"required":["id","ips"],"additionalProperties":false}},{"name":"setProxyLimits","description":"Set the traffic or spending limit on a proxy resource to control costs. A proxy has one limit: this call replaces any existing limit, and total_limit 0 removes it. The counter resets daily or monthly according to time_period. Returns the updated proxy with the applied limits. To change other settings in the same call, use updateProxyResource. Response fields: docs://proxy-settings/setProxyLimits.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Proxy resource ID. Get from listProxyResources."},"limit_type":{"type":"string","description":"'money' = USD spend cap, 'traffic' = bytes cap"},"time_period":{"type":"string","description":"Reset period for the limit counter, one of: daily, monthly"},"total_limit":{"type":"number","description":"Limit value: USD amount for 'money' (e.g. 50.00), bytes for 'traffic' (e.g. 1073741824 = 1GB). Set to 0 to remove the limit."}},"required":["id","limit_type","time_period","total_limit"],"additionalProperties":false}},{"name":"setProxyTargetHosts","description":"Replace the target host whitelist for a proxy resource, restricting its traffic to the given domains. This controls where the proxy can connect; to control who can authenticate, use setProxyIpWhitelist. Returns the updated proxy with the applied target host whitelist. Response fields: docs://proxy-settings/setProxyTargetHosts.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Proxy resource ID. Get from listProxyResources."},"target_hosts":{"type":["null","array"],"items":{"type":"string"},"description":"List of allowed domains, e.g. ['example.com', '*.api.service.com']. Empty array removes all restrictions."}},"required":["id","target_hosts"],"additionalProperties":false}},{"name":"updateProxyResource","description":"Update description, countries, status, IP whitelist, or limits in one call. Name and proxy_type are not mutable through this MCP tool. For single-field changes, prefer setProxyIpWhitelist, setProxyLimits, or deactivateProxyResource. Returns the complete updated proxy without its password. Response fields: docs://proxies/updateProxyResource.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Proxy resource ID. Get from listProxyResources."},"description":{"type":"string","description":"New description. See createProxyResource's description field for what to include."},"countries":{"type":["null","array"],"items":{"type":"integer","minimum":0},"description":"Replacement country IDs; empty clears."},"status":{"type":"string","description":"New status, one of: active, inactive"},"ip_whitelist":{"type":["null","array"],"items":{"type":"string"},"description":"New IP whitelist. Replaces the existing list entirely. Empty array removes all restrictions."},"limits":{"type":["null","object"],"properties":{"limit_type":{"type":"string","description":"'money' = USD spend cap, 'traffic' = bytes cap"},"time_period":{"type":"string","description":"Reset period for the limit counter, one of: daily, monthly"},"total_limit":{"type":"number","description":"Limit value: USD amount for 'money', bytes for 'traffic'"}},"description":"New spend or traffic limit. Replaces the existing limit.","required":["limit_type","time_period","total_limit"],"additionalProperties":false}},"required":["id"],"additionalProperties":false}}],"scan":{"score":91,"grade":"A","scanned_at":"2026-10-26T05:00:12.162Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-26T05:00:12.033Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 1875ms"]},"poisoning":{"score":15,"max":15,"notes":["20 tool descriptions checked"]},"auth":{"score":8,"max":15,"notes":["API key sent as a header"]},"maintenance":{"score":15,"max":15,"notes":["last push 3 days ago"]},"identity":{"score":10,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year","website matches verified namespace"]}},"findings":[],"inputs":{"probes":[{"url":"https://mcp.2extract.com/mcp","reachable":true,"authRequired":false,"latencyMs":1875,"serverInfo":{"name":"2extract-mcp-public","version":""}}],"packages":[],"repo":{"found":true,"owner":"2extract","repo":"mcp","archived":false,"pushedAt":"2026-10-23T12:16:07Z","stars":1,"forks":0,"openIssues":0,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/224570469?v=4","ownerCreatedAt":"2025-08-04T11:38:53Z","license":"MIT"},"icon":{"url":"https://framerusercontent.com/images/QiMjTPZY6fEphTKo2cVWK5w4M4M.svg","source":"site"},"presence":{"stars":1,"forks":0,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-10-23T12:16:07.000Z","score":26}}}},"grade_history":[],"reviews":[]}