How to Use the ChargeDesk MCP in CrewAI

Deploy a CrewAI team to manage your ChargeDesk account. One agent finds issues, another fixes them, automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ChargeDesk MCP to CrewAI

Create your Vinkius account to connect ChargeDesk to CrewAI 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 ChargeDesk with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Assemble a Billing Operations Crew

With CrewAI, you can assign specific ChargeDesk tools to different agents. Create a "Billing Analyst" agent that can only read data using `list_chargedesk_charges` and `get_customer_details`. This agent's job is to monitor for failed payments or disputes. Then, create a "Resolution Specialist" agent with access to `refund_chargedesk_payment`. When the Analyst agent finds a problem, it passes the context to the Specialist, who can then take action. This separation of duties makes your autonomous system safer and more organized.

Autonomous Customer Support Teams

Build a crew to handle customer billing inquiries. A "Support Triage" agent can use `get_customer_details` to pull up a customer's account and identify the issue. It then passes the case to a specialized agent. For a refund request, the case goes to the "Refund Agent" which uses `refund_chargedesk_payment`. For a subscription question, it goes to the "Subscription Agent" that uses `list_chargedesk_subscriptions`. CrewAI coordinates the handoff, and this MCP Server provides the tools for each role.

Proactive Account Monitoring with a CrewAI MCP Server

You don't have to wait for problems to happen. Deploy a "System Monitor" agent that periodically runs `list_connected_gateways` and `list_chargedesk_webhooks`. Its only job is to make sure your payment infrastructure is configured correctly and online. If the Monitor agent detects a disconnected gateway or a missing webhook, it can create a task for a "DevOps" agent. This second agent can then notify a human operator. This is how you use a CrewAI team for proactive, autonomous maintenance of your billing system.

Setup guide

Set up ChargeDesk MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke ChargeDesk tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="ChargeDesk Analyst",
    goal="Access and analyze ChargeDesk data via MCP.",
    backstory="Expert analyst with direct ChargeDesk access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent ChargeDesk transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="ChargeDesk Analyst",
        goal="Access and analyze ChargeDesk data via MCP.",
        backstory="Expert analyst with direct ChargeDesk access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent ChargeDesk transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 ChargeDesk. 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 ChargeDesk 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 ChargeDesk MCP in CrewAI

The simplest way is to pass your Vinkius URL directly into the `mcps` parameter when defining an Agent. For more control, use `MCPServerHTTP` and the `tool_filter` to assign specific ChargeDesk tools to specific agents.

Yes, that's a core strength of using ChargeDesk with CrewAI. You can create a "read-only" analyst agent with tools like `list_chargedesk_charges` and a separate "write" agent with access to `refund_chargedesk_payment`.

A great example is an autonomous dispute resolution team. One agent monitors for new disputes, a second agent gathers customer history using `get_customer_details`, and a third decides whether to issue a refund via `refund_chargedesk_payment`.

It's designed for complex, collaborative tasks. While you can use it for simple things, the real power of CrewAI and this MCP server is building autonomous teams that manage parts of your ChargeDesk account without human intervention.

Vinkius secures the connection from end to end. Your agents communicate with the ChargeDesk tools through an encrypted, zero-trust channel. The server logic runs in an ephemeral sandbox that is wiped clean after each run, so no customer PII or payment details are ever persisted on the Vinkius side.

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