How to Use the Nimble CRM (Social Sales CRM & Contacts API) MCP in Pydantic AI

Q: How do I install Nimble CRM (Social Sales CRM & Contacts API) for Pydantic AI?

Run pip install pydantic-ai-slimmcp in your terminal. Then, initialize the MCPToolset using your Vinkius URL and pass it to your Agent's toolsets parameter.

Validate your Nimble CRM contact data at runtime with type-safe Pydantic AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nimble CRM (Social Sales CRM & Contacts API) MCP to Pydantic AI

Create your Vinkius account to connect Nimble CRM (Social Sales CRM & Contacts API) 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 Nimble CRM (Social Sales CRM & Contacts API) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Enforce strict schemas on contact retrieval

The `get_contact` tool fetches detailed JSON payloads for specific contact records. Pydantic AI intercepts this payload and validates it against your defined Python models at runtime. If the CRM returns an unexpected field or a missing value, your agent raises a validation error immediately rather than corrupting your database. This prevents silent failures in your production pipelines. This MCP Server ensures you write clean, type-hinted code, and the framework ensures the data matches your expectations before your agent acts on it.

Safeguard deletions with an MCP Server

The `delete_contacts` tool removes specified contact records from your CRM permanently. In Pydantic AI, you can wrap this destructive tool in a validated agent run that requires explicit boolean confirmations. The agent must verify that the target contact ID exists and matches your deletion criteria before executing the command. This setup eliminates accidental bulk deletions caused by model hallucinations. Because Pydantic AI is model-agnostic, this safety layer works whether you use local models or commercial APIs.

Verify your API credentials at runtime

The `get_myself` tool retrieves the authenticated CRM user's profile details to confirm your connection status. Your agent runs this check during startup to verify that your API key is valid and has the correct permissions. It prevents your application from running queries with expired credentials. Using the unified `MCPToolset` class makes registration simple. You point it at your Vinkius HTTP endpoint, and your agent gets type-safe access to your user data instantly.

Setup guide

Set up Nimble CRM (Social Sales CRM & Contacts API) 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": {
        "nimble-crm-social-sales-crm-contacts-api-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Nimble CRM (Social Sales CRM & Contacts API) tools.",
)

result = await agent.run("List recent Nimble CRM (Social Sales CRM & Contacts API) 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 Nimble CRM. 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 Nimble CRM (Social Sales CRM & Contacts API) 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 Nimble CRM (Social Sales CRM & Contacts API) MCP in Pydantic AI

Run pip install pydantic-ai-slim[mcp] in your terminal. Then, initialize the MCPToolset using your Vinkius URL and pass it to your Agent's toolsets parameter.

Pydantic AI will raise a ValidationError at runtime. This stops the agent from processing bad data, protecting your downstream databases from corruption.

No, you should use the unified MCPToolset class. Pydantic AI has deprecated MCPServerHTTP in favor of this single, clean interface for HTTP and SSE transports.

Yes. Pydantic AI is model-agnostic. You can connect this toolset to local models via Ollama or Llamafile, and the framework will still enforce strict runtime type validation.

All contact validation occurs in your local runtime memory. Vinkius operates as a pass-through proxy using secure, isolated V8 sandboxes, meaning your CRM contacts are never cached or stored on our infrastructure.

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