# Decodo (Smartproxy) MCP MCP > Decodo (Smartproxy) MCP lets your AI agent manage your proxy network infrastructure from inside your IDE. Pull lists of residential, datacenter, and dedicated proxies; check current traffic usage against quotas; or pull scraper performance metrics with simple prompts. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** proxy-network, web-scraping, network-infrastructure, ip-management, bandwidth-monitoring ## Description Stop switching between dashboard tabs just to copy-paste a list of endpoints. This MCP connects your Decodo account directly to your AI client, letting you handle complex proxy network tasks using natural language. You can instantly get a full inventory by running `list_proxy_endpoints`, `list_datacenter_proxies`, and `list_residential_proxies`. Need to know if you're hitting your monthly quota? Just ask for the traffic usage statistics. Your agent will check that data for you, keeping you in sync with your network limits without leaving your workflow. It also tracks bot health by pulling scraper stats or viewing account subscriptions. If you use Vinkius, this MCP gives you a single place to manage all those critical infrastructure details, letting you work faster than clicking through any web portal. ## Tools ### get_account_details Fetches general information about your Decodo account status. ### get_scraper_stats Retrieves detailed statistics on the success and failure rates of scraping jobs. ### get_traffic_usage Reports how much data you’ve used against your total bandwidth limit. ### list_datacenter_proxies Pulls a list of all available datacenter proxy configurations for your account. ### list_dedicated_proxies Lists the specific, dedicated IP addresses assigned to your network. ### list_proxy_endpoints Gathers a general list of all currently active proxy endpoints across pools. ### list_residential_proxies Provides a list of residential IP configurations, mimicking real user devices. ### list_sub_users Lists all individual sub-user accounts created under your main proxy subscription. ### list_subscriptions Shows the details of every active proxy service plan you have purchased. ## Prompt Examples **Prompt:** ``` Find all of our active datacenter proxy endpoints. ``` **Response:** ``` Here are the Datacenter Proxy Endpoints bound to your subscription: - US-East Pool (hostname: `gate.dc.smartproxy.com:20000`) - EU-Central Pool (hostname: `gate.dc.smartproxy.com:20001`) Both are operational. Would you like me to insert snippet usage into a Python Request block? ``` **Prompt:** ``` Use Decodo and query my scraping success rate summary. ``` **Response:** ``` Running a stat check using the get_scraper_stats module... - API Hits Total: 4,025 requests - Successful: 3,901 (96.9% rate) - Blocked/Timeout: 124 (3.1% rate) Your Google SERP APIs are performing excellently right now. ``` **Prompt:** ``` Have we exceeded the traffic usage on the account? ``` **Response:** ``` Checking your subscription details... You have a total cap of 100 GB. Current usage reflects 78.4 GB used (78% of your overall allocation). You are completely safe for now, with roughly 21.6 GB left this billing cycle. ``` ## Capabilities ### List proxy endpoints The agent pulls detailed lists of available datacenter, residential, and general proxy addresses. ### Monitor bandwidth usage You check your account's current traffic consumption against the total allocated quota. ### Audit scraper performance The agent retrieves success rates and failure counts for specific scraping tasks (like SERP data). ### View network assignments You list dedicated proxy IP addresses or check all active sub-user accounts. ## Use Cases ### The scraper is failing mysteriously. A data engineer notices scraping failure spikes. They prompt their agent to run `get_scraper_stats` and it returns a 3.1% block rate. Then, they check the usage with `get_traffic_usage` to see if the high traffic volume caused the blocks. The agent confirms the quota is fine, pointing them toward an IP rotation issue. ### Need to audit all available IPs for a new project. A web scraping operator needs a massive pool of test IPs. They ask their agent to run `list_proxy_endpoints` alongside `list_residential_proxies`. The tool compiles everything into a single, clean list ready for copy-pasting into code. ### Diagnosing rate limits on an assigned IP. A network admin suspects their dedicated proxy is hitting limits. They use `list_dedicated_proxies` to check the assignment details, and then ask the agent to cross-reference that with general `get_account_details` information to determine if it's a service limit or a quota issue. ### Reviewing team access and billing limits. A SaaS operator needs to check if their junior staff are running up unnecessary costs. They run `list_sub_users` to see everyone who has an account, then use the agent to get bandwidth usage reports for specific users. ## Benefits - You save time by consolidating all necessary data points. Instead of pulling multiple reports, you can ask your agent to get the traffic usage and list sub-users in a single prompt. - The `get_scraper_stats` tool gives immediate feedback on bot health. You see if your SERP APIs are running fine or if they’re starting to fail before your script breaks. - You gain full visibility over your network assets. Use `list_datacenter_proxies` and `list_residential_proxies` together to build a complete picture of all available IP types. - Diagnosis is faster when you need it most. The agent can run `list_dedicated_proxies` so you quickly diagnose if rate-limiting errors are tied to a specific assigned network. - Account oversight becomes simple. You pull everything from `list_subscriptions` and `get_account_details` in one go, giving you a clear picture of your whole infrastructure. - You manage capacity risk effortlessly. Before running a big scrape job, check the traffic usage to make sure you don't blow past your monthly data quota. ## How It Works The bottom line is that your AI client talks to Decodo using these tools so you don't have to manually navigate any dashboards. 1. Subscribe to the MCP and input your Decodo API key into your AI client. 2. Ask your agent a question, like 'What are my residential proxies?' 3. The MCP executes the necessary tool call and sends you a clean list or metric report directly in your chat window. ## Frequently Asked Questions **How do I check my bandwidth quota with get_traffic_usage?** You simply ask your agent to run the `get_traffic_usage` tool. It compares your current consumption against your total cap and tells you exactly how much data is left in GB. **What tools list available proxy endpoints?** There are several listing functions: use `list_proxy_endpoints` for a general view, or be specific by calling `list_datacenter_proxies`, `list_residential_proxies`, or `list_dedicated_proxies`. **Does the MCP help with bot performance using get_scraper_stats?** Yes, it runs `get_scraper_stats`. This tool gives you a quick breakdown of your scraping success rate versus how often requests are blocked or time out. **Can I see which sub-users exist using list_sub_users?** Yes, calling `list_sub_users` pulls a complete roster of all active sub-accounts linked to your primary proxy subscription for auditing purposes. **How do I check my current plan status or active paid plans using list_subscriptions?** It lists all your active proxy subscriptions. This helps you quickly audit which packages are running and when those services renew, making reselling management straightforward. **If I suspect rate-limiting issues, how does list_dedicated_proxies help me diagnose the problem?** It provides a specific inventory of all dedicated proxy assignments. You can compare these listed endpoints against your usage pattern to pinpoint if a single network pool is causing throttling. **What information can get_account_details provide about my core account health?** This function retrieves general, high-level details about your entire Smartproxy account. It's useful for verifying API key status or checking overall credential integrity before running complex scripts. **Where can I find all the specific datacenter IPs using list_datacenter_proxies?** This tool gives you a dedicated listing of your data center proxy configurations. It filters out residential or general endpoints, letting you focus only on high-volume DC IP pools.