How to Use the Workvivo MCP in Pydantic AI

Q: Can I list spaces using Workvivo with Pydantic AI?

Yes. When you call listcollaborationspaces, the resulting list is validated, meaning you get clean, predictable data that your code can trust without guesswork.

Q: What’s the process for deleting content on Workvivo using Pydantic AI?

You use deletesocialpost. Because of the type safety, even an irreversible action like this must pass validation first.

Q: Does Workvivo support fetching details with Pydantic AI?

It does. Whether you need space data via getspacedetails or company event lists via listcompanyevents, the output is always reliable and predictable.

Build reliable Workvivo automation with Pydantic AI type safety.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Workvivo MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Posts on the Activity Feed

Use `create_social_post` to publish text updates directly into the Workvivo activity feed. You can also run `delete_social_post`, which permanently removes a post. The agent validates these actions rigorously. This ensures that every time your system posts or deletes content, the data structure is correct and you avoid corrupted records.

List and Inspect Company Directory Data

The tool `list_employees` pulls a directory list of all registered workers. When using `get_employee_profile`, the agent validates that every returned field matches its expected schema. Need to know what groups exist? Running `list_collaboration_spaces` gives you structured data on available spaces.

Retrieve Details for Events and Content

You can get event details using `get_event_details`, or pull specific post information with `get_post_details`. These tools provide strongly typed outputs. Want to see what's happening? The agent uses `list_workvivo_posts` to gather recent social activity, and the response will always conform to your defined models.

Setup guide

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

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

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

Pydantic AI ensures that every piece of data coming from Workvivo—whether it’s an employee list or a post—is validated against Python models. This stops silent corruption.

This server handles posts, profiles, event details, and space lists. The agent treats all of this organizational information as strongly typed records for maximum correctness.

Yes. When you call `list_collaboration_spaces`, the resulting list is validated, meaning you get clean, predictable data that your code can trust without guesswork.

You use `delete_social_post`. Because of the type safety, even an irreversible action like this must pass validation first.

It does. Whether you need space data via `get_space_details` or company event lists via `list_company_events`, the output is always reliable and predictable.

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