How to Use the Funil de Vendas MCP in Pydantic AI

Q: What happens if the Funil de Vendas API changes and a Pydantic AI agent calls it?

Your agent will fail loudly with a ValidationError. Pydantic AI's runtime validation catches any deviation from the expected schema, protecting your Funil de Vendas data from corruption.

Q: How can I get a list of all products from my Funil de Vendas account?

Have your agent call the listcrmproducts tool. Pydantic AI will parse the response, ensuring you get a clean, validated list of product objects to work with in your code.

Build type-safe CRM agents with Pydantic AI to ensure every Funil de Vendas interaction is validated and correct.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Funil de Vendas MCP to Pydantic AI

Create your Vinkius account to connect Funil de Vendas to Pydantic 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 Funil de Vendas with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Guarantee Valid CRM Writes

Stop worrying about bad data corrupting your pipeline. When your agent uses `create_new_deal_lead` or `update_crm_activity`, Pydantic AI validates the response against a strict schema. If Funil de Vendas ever returns an unexpected field or a malformed response, your agent will raise a `ValidationError` immediately. No silent failures, no garbage data in your CRM.

Query Your Pipeline with Confidence

Fetching data is just as safe as writing it. When your agent calls `list_crm_opportunities` or `list_crm_activities`, every single record returned is parsed and validated by a Pydantic model. This means you can trust the data structures your agent works with. You know a deal object will always have the fields you expect, because Pydantic AI guarantees it at runtime.

A Pydantic AI-Ready MCP Server

This server is designed for model-agnostic, type-safe operations. Your agent can discover your CRM's structure by calling `list_sales_funnels` and `list_crm_custom_fields`. The `MCPToolset` makes setup trivial. Just point it at the server URL, and your agent gets a full set of validated tools for interacting with Funil de Vendas, no matter which LLM you're using.

Setup guide

Set up Funil de Vendas MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "funil-de-vendas-alternative-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Funil de Vendas tools.",
)

result = await agent.run("List recent Funil de Vendas transactions")
print(result.output)

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 Funil de Vendas. 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 Funil de Vendas 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 Funil de Vendas MCP in Pydantic AI

Pydantic AI validates the API response after your agent calls `create_new_deal_lead`. If the data from Funil de Vendas doesn't match the expected schema, your code gets a `ValidationError` instead of a corrupted object.

Your agent will fail loudly with a `ValidationError`. Pydantic AI's runtime validation catches any deviation from the expected schema, protecting your Funil de Vendas data from corruption.

Yes. Pydantic AI is model-agnostic. As long as your local model can use tools, it can connect to this MCP server and perform validated actions on your Funil de Vendas account.

Have your agent call the `list_crm_products` tool. Pydantic AI will parse the response, ensuring you get a clean, validated list of product objects to work with in your code.

Your Funil de Vendas data, including customer opportunities and activities, is processed within a secure, single-tenant sandbox on Vinkius. Communication is encrypted, and your API credentials are used ephemerally for each request, never stored.

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