How to Use the Nimble CRM (Social Sales CRM & Contacts API) MCP in OpenAI Agents SDK

Build production-grade Python agents that manage your Nimble CRM contacts with built-in guardrails via the OpenAI Agents SDK.

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 OpenAI Agents SDK

Create your Vinkius account to connect Nimble CRM (Social Sales CRM & Contacts API) to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Clean up stale leads with OpenAI Agents SDK

The `delete_contacts` tool removes outdated or duplicate contact records directly from your database. Your agent identifies contacts that haven't interacted in years, passes them through your custom guardrail validation, and executes the purge. This keeps your sales pipeline clean without manual data entry. Behind the scenes, the OpenAI dashboard tracks every single deletion. If an agent tries to wipe a contact that doesn't meet your criteria, the SDK halts the execution before any API call is made.

Audit active accounts using this MCP Server

The `list_contacts` tool queries your contact database to pull active records based on your parameters. Your agent runs this query to build targeting lists, verify missing fields, or hand off specific segments to specialized sub-agents. It operates directly within your Python pipeline to keep your data synchronized. Setting this up takes a few lines of code. You initialize the `MCPServerStreamableHttp` client, register it in the Agent constructor, and let the model discover the tool automatically.

Inspect specific records with deep tracing

The `get_contact` tool fetches detailed profiles, social data, and history for a specific record ID. When your agent needs to prepare a briefing before a sales call, it calls this tool to gather context. You get raw, structured data without writing custom wrapper functions. Using this MCP Server with the OpenAI Agents SDK means you can cache the tool list. This reduces latency on repeated queries and keeps your agent responsive during live user interactions.

Setup guide

Set up Nimble CRM (Social Sales CRM & Contacts API) MCP in OpenAI Agents SDK

Prerequisites

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

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Nimble CRM (Social Sales CRM & Contacts API) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Nimble CRM (Social Sales CRM & Contacts API) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Nimble CRM (Social Sales CRM & Contacts API) tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Nimble CRM (Social Sales CRM & Contacts API) Agent",
            instructions="You have access to Nimble CRM (Social Sales CRM & Contacts API) tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Install the package using pip install openai-agents. Then, configure the HTTP transport using MCPServerStreamableHttp with your Vinkius endpoint URL and pass it to your Agent constructor. The SDK auto-discovers the tools immediately.

Yes. You can manage tool access by setting up specific agent roles or using the SDK's built-in guardrails to intercept tool calls like `delete_contacts`. This ensures your agent only reads data when it should.

Yes, it works across agent handoffs. One specialized agent can use `list_contacts` to find prospects, then hand the structured data to a closer agent that uses `get_contact` to analyze the profile.

The SDK passes rate limit headers directly through the stream. To avoid hitting limits, enable cacheToolsList=True in your configuration to stop the agent from repeatedly querying the server for tool definitions.

Your contact data and user profiles route directly through Vinkius's ephemeral, zero-trust sandbox. No contact details or authentication tokens are stored on our servers. Everything is destroyed the moment your session ends.

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