How to Use the Alegra MCP in CrewAI

Q: How do I assign Alegra MCP Server tools to specific CrewAI agents?

Pass the server HTTP endpoint in the mcps array when defining your agent. This lets you restrict specific tools like createinvoice to your billing agent while keeping other agents isolated.

Q: Can CrewAI agents share Alegra data with each other?

Yes, CrewAI's shared memory allows an agent running listestimates to pass quote data to a sales agent, who then uses it to compile a final invoice.

Q: How do CrewAI agents handle failing Alegra API calls?

If a tool like listpayments fails, the agent uses its internal reasoning loop to retry the action or escalate the issue to a moderator agent for manual review.

Q: Can I filter which Alegra MCP tools a CrewAI agent can access?

Yes, you can use MCPServerHTTP to filter tools, ensuring your research agent can only run getitemdetails while blocking access to financial tools.

Deploy a cooperative team of CrewAI agents to manage your Alegra invoices, inventory, and contacts autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Alegra MCP to CrewAI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-agent billing audits with CrewAI

The `list_invoices` tool gives your auditing agents full access to sales records. A CrewAI billing agent pulls the transaction history, while a separate compliance agent reviews each invoice to flag discrepancies or missing tax details. If errors are found, the compliance agent instructs a coordinator agent to run `get_invoice_details` for a deeper check. The agents share this data through CrewAI's memory layer, resolving billing issues without human intervention.

Collaborative stock management using this MCP Server

The `list_inventory_items` tool feeds stock data directly to a specialized warehouse agent. When stock drops, this agent alerts a purchasing agent to research suppliers, coordinating the entire restock plan in the background. The purchasing agent then uses `get_item_details` to verify supplier SKU matches before drafting a purchase order. This collaborative loop keeps your stock levels balanced without requiring manual inventory audits.

Multi-agent customer onboarding pipelines

The `create_contact` tool allows onboarding agents to register new clients the moment they sign a contract. A CRM agent collects the client details, while an accounting agent verifies billing terms before writing to Alegra via this MCP Server. Once registered, a verification agent runs `get_contact_details` to ensure the profile matches your internal records. The agents coordinate this handoff sequentially, ensuring clean customer databases from day one.

Setup guide

Set up Alegra 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 Alegra tools as needed.

crew.py

from crewai import Agent, Task, Crew

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

task = Task(
    description="List recent Alegra 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="Alegra Analyst",
        goal="Access and analyze Alegra data via MCP.",
        backstory="Expert analyst with direct Alegra access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Alegra 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 Alegra. 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 Alegra 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 Alegra MCP in CrewAI

Pass the server HTTP endpoint in the `mcps` array when defining your agent. This lets you restrict specific tools like `create_invoice` to your billing agent while keeping other agents isolated.

Yes, CrewAI's shared memory allows an agent running `list_estimates` to pass quote data to a sales agent, who then uses it to compile a final invoice.

If a tool like `list_payments` fails, the agent uses its internal reasoning loop to retry the action or escalate the issue to a moderator agent for manual review.

Yes, you can use `MCPServerHTTP` to filter tools, ensuring your research agent can only run `get_item_details` while blocking access to financial tools.

All tool executions run through an ephemeral, zero-trust sandbox. Your customer profiles and payment records remain private because the MCP Server processes data locally in memory without writing to persistent external storage.

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