How to Use the Gong MCP in Pydantic AI

Q: How do I register the Gong MCP Server with my Pydantic AI agent?

Install pydantic-ai-slimmcp and use the MCPToolset class initialized with your Vinkius HTTP endpoint. Pass this toolset directly into your Agent constructor to give your model validated access to all 12 MCP tools.

Q: How do I inspect active trackers and scorecards?

Your agent can call listtrackers to fetch configured keywords and listscorecards to see active rubrics. The framework validates these lists against strict schemas, letting your agent safely grade conversations.

Build type-safe sales intelligence agents with Pydantic AI to guarantee valid call data at runtime.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gong MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Strict runtime validation for Pydantic AI agents

The `get_transcript` tool delivers raw call text that is immediately validated against strict Pydantic models at runtime. If the API structure changes or returns unexpected fields, Pydantic AI fails loudly, preventing corrupted data from entering your analysis. This type safety ensures your agent only processes clean, structured text. You can run assertions on the transcript data before passing it to your LLM, ensuring highly accurate coaching feedback.

Validate team metrics using this MCP Server

The `get_interaction_stats` tool retrieves aggregate performance metrics and parses them directly into typed Python schemas. Your agent can immediately verify that fields like talk-time and silence duration match your expected data types. This MCP Server allows your Pydantic AI agent to make decisions based on guaranteed data structures. If you fetch user lists via `list_users`, the framework ensures every user ID and email matches your defined system schemas.

Type-safe search and filtering of sales calls

The `search_calls` tool executes complex queries across your conversation history with full type safety. The returned call objects are validated against your Pydantic models, protecting your pipeline from silent failures. Once your agent finds the target calls, it can use `get_call` to retrieve deep metadata. Every field, from timestamps to participant lists, is checked at runtime to ensure your application remains stable under heavy production loads.

Setup guide

Set up Gong 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": {
        "gong-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent Gong 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 Gong. 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 Gong 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 Gong MCP in Pydantic AI

Install pydantic-ai-slim[mcp] and use the MCPToolset class initialized with your Vinkius HTTP endpoint. Pass this toolset directly into your Agent constructor to give your model validated access to all 12 MCP tools.

The framework will raise a validation error instantly. Instead of letting your agent hallucinate or process broken data from get_call or get_transcript, the execution halts so you can handle the error programmatically.

Yes. Pydantic AI is model-agnostic, meaning you can run your validated tools with OpenAI, Gemini, Anthropic, or local models. The framework handles the schema validation regardless of which model processes the tool output.

Your agent can call list_trackers to fetch configured keywords and list_scorecards to see active rubrics. The framework validates these lists against strict schemas, letting your agent safely grade conversations.

All performance metrics and scorecard configurations remain fully encrypted in transit. This integration uses secure, single-token authentication through the Vinkius gateway, ensuring your team's internal coaching metrics are never exposed or cached externally.

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