How to Use the Alegra MCP in CrewAI

Q: Can I limit which Alegra tools my CrewAI agents can access?

Yes, you can use CrewAI's MCPServerHTTP class to filter the MCP Server tools exposed to specific agents. This lets you restrict access to sensitive Alegra tools like createinvoice while allowing other agents to read data.

Q: What happens if an agent tries to create a contact that already exists?

The CrewAI agent will receive an error from createcontact and attempt to self-correct. It will analyze the error, run listcontacts to find the existing profile, and update it instead of failing.

Deploy an autonomous crew of specialized CrewAI agents to manage your Alegra invoicing, tax reports, and client communication.

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 LatAm billing operations in CrewAI

Set up specialized agents to scan for unpaid bills using `list_invoices` while collaborating on your accounting tasks. You can set up an Auditor agent to find the records, while a Billing agent drafts the invoices. If a discrepancy pops up, the agents collaborate to check `get_invoice_details` and resolve the issue before notifying your team. This setup runs completely on autopilot without human intervention. By letting this MCP Server handle the communication with your accounting platform, your agents can focus on analyzing the data instead of formatting API payloads.

Automated vendor onboarding and verification

Let your agents run `list_contacts` to handle vendor relations and verify existing profiles from start to finish. A Researcher agent can pull new vendor details from incoming emails, while an Onboarding agent checks to see if they already exist in your system. If the vendor is new, the agent calls `create_contact` to set up their profile automatically. The agents share a common memory, meaning they won't repeat steps or create duplicate entries. They can also check `get_company_info` to ensure the tax IDs align with your local country requirements.

Autonomous inventory and sales auditing

Query your inventory catalog using `list_inventory_items` to ensure your sales pipeline matches your physical stock levels. An Auditor agent can run the check, while a Sales agent cross-references this with pending estimates. If an item is running low, the agent uses `get_item_details` to pull the supplier details and draft a restock order. This MCP Server keeps your sales team from selling items that are out of stock, protecting your customer relationships. The crew can run these audits on a schedule or trigger them based on specific events.

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

You can pass the MCP URL directly into your CrewAI agent's configuration using the `mcps` parameter. This instantly exposes Alegra tools like `list_invoices` to your entire crew.

Yes, you can use CrewAI's `MCPServerHTTP` class to filter the MCP Server tools exposed to specific agents. This lets you restrict access to sensitive Alegra tools like `create_invoice` while allowing other agents to read data.

CrewAI agents use a shared memory system to pass Alegra context. When one agent fetches details using `get_contact_details`, that information is instantly available to other agents in the crew.

The CrewAI agent will receive an error from `create_contact` and attempt to self-correct. It will analyze the error, run `list_contacts` to find the existing profile, and update it instead of failing.

All Alegra payment records, tax details, and transaction histories accessed via `list_payments` are protected by Vinkius's secure MCP proxy layer. Your credentials are never exposed to the CrewAI agents or the LLM providers, ensuring your financial logs remain strictly confidential.

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