How to Use the Decodo (Smartproxy) MCP in Mastra AI

Q: Can I require human approval before an agent makes a change?

Yes, Mastra supports requireToolApproval. You could build a workflow where an agent suggests disabling a sub-user based on gettrafficusage data, but it waits for your confirmation before acting.

Automate your proxy infrastructure with resilient workflows using Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Decodo (Smartproxy) MCP to Mastra AI

Create your Vinkius account to connect Decodo (Smartproxy) to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Decodo (Smartproxy) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Self-Healing Proxy Workflows

This server gives your Mastra AI agents direct control over your Decodo proxy network. You can build workflows that don't just use proxies, but manage them. It's for creating automated systems that handle failures gracefully. For example, a workflow could try a request with a proxy from `list_residential_proxies`. If it fails, Mastra's engine can automatically retry with a different proxy from `list_datacenter_proxies` and log the issue.

Conditional Logic for Bandwidth Management

Use Mastra AI's workflow engine to actively manage your Decodo bandwidth. Your agent can periodically check usage and make decisions based on the results. This isn't just monitoring; it's active, automated control. Set up a workflow that runs `get_traffic_usage` every hour. If usage exceeds 80%, the agent could then use `list_sub_users` to find heavy consumers and send an alert. This is the kind of reliable automation Mastra is built for.

Your Decodo MCP Server for Complex Jobs

The Decodo (Smartproxy) tools become building blocks for your Mastra AI agents. You can chain commands together to perform complex, multi-step operations on your proxy infrastructure without writing a ton of custom code. An agent could `list_subscriptions` to check for an active plan, then `list_proxy_endpoints` to find the correct endpoint for a job, and finally execute the task. Mastra's engine ensures each step completes before the next one starts.

Setup guide

Set up Decodo (Smartproxy) MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Decodo (Smartproxy) tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "decodo-smartproxy-mcp-client",
  servers: {
    "decodo-smartproxy-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Decodo (Smartproxy) Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Decodo (Smartproxy) tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Decodo (Smartproxy) transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Decodo (Smartproxy). All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Decodo (Smartproxy) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Decodo (Smartproxy) MCP in Mastra AI

After setting up the MCPClient with your Vinkius URL, you just list the tools you want the agent to have. Mastra automatically makes `get_traffic_usage`, `list_sub_users`, and others available to your agent's logic.

Absolutely. You'd build a workflow where the agent tries a proxy from `list_residential_proxies`. Using Mastra's error handling, you can define a fallback step that fetches a new proxy from `list_datacenter_proxies` and retries the job.

Reliability. Mastra provides automatic retries, conditional branching, and state management for your Decodo (Smartproxy) operations. It turns simple API calls into a durable, automated process that can handle real-world failures.

Yes, Mastra supports `requireToolApproval`. You could build a workflow where an agent suggests disabling a sub-user based on `get_traffic_usage` data, but it waits for your confirmation before acting.

Your connection is secured by your unique Vinkius endpoint token. The MCP server processes requests for your proxy account details and usage stats in an ephemeral, sandboxed environment. No data is stored, and each request is isolated.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript