How to Use the Lichess.org Open Chess Intelligence MCP in Pydantic AI

Q: How does this server protect my private Lichess team rosters and member lists?

The server only reads public endpoints for tools like getteammembers. It handles all API requests through ephemeral, zero-trust isolates, meaning your team roster data is never cached or shared.

Build type-safe chess analysis pipelines in Pydantic AI with strict runtime validation using this dedicated MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Lichess.org Open Chess Intelligence MCP to Pydantic AI

Create your Vinkius account to connect Lichess.org Open Chess Intelligence 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 Lichess.org Open Chess Intelligence with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-Safe Game and Profile Parsing in Pydantic AI

The `get_player_data` tool fetches public profile statistics with strict runtime type validation. Your agent will fail instantly and loudly if Lichess returns unexpected field structures, preventing corrupted data from entering your database. This strict validation ensures your chess rating calculators and win-loss trackers always receive clean integers. Pydantic AI enforces these schemas automatically without requiring custom try-except blocks.

Validated Leaderboards and Puzzles

The `get_leaderboards` tool retrieves top player rankings across all chess variants, from bullet to classical. Your agent processes these lists knowing that every username and rating score matches your exact Pydantic models. You can also run `get_daily_puzzle` to fetch the daily tactical challenge. If the API structure changes, the validation layer catches it before your agent can hallucinate a wrong solution path.

Live Activity and Status Monitoring

The `get_users_online_status` tool checks the real-time presence of multiple players in a single API call. Your agent can use this to coordinate matches or track rival availability without polling individual profiles. Combine this with `get_user_activity` to see what those players did during their last active session. The Pydantic AI MCP toolset handles the SSE transport connection, keeping your event loop responsive.

Setup guide

Set up Lichess.org Open Chess Intelligence 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": {
        "lichessorg-open-chess-intelligence-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent Lichess.org Open Chess Intelligence 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 Lichess.org. 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 Lichess.org Open Chess Intelligence 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 Lichess.org Open Chess Intelligence MCP in Pydantic AI

It guarantees that all chess data, from puzzle solutions to player ratings, matches your Python types at runtime. This prevents silent failures and keeps your chess analytics database clean.

Use the MCPToolset class with the server's HTTP URL. Pass this toolset directly to your Agent constructor to expose all ten chess tools.

Yes, you can use the SSE transport to handle real-time data from `list_broadcasts`. This allows your agent to receive live move updates as they happen.

You should implement standard backoff decorators on your agent calls. Because Pydantic AI fails loudly on validation errors, a rate-limit response will be caught immediately.

The server only reads public endpoints for tools like `get_team_members`. It handles all API requests through ephemeral, zero-trust isolates, meaning your team roster data is never cached or shared.

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