MCP Server
Polyhedral exposes an MCP (Model Context Protocol) server so AI coding assistants can read and write your game data — notes, encounters, library resources, dice rolls, and more.
Prerequisites
- A paid plan. MCP access and API keys are not available on the free plan.
- Open Connected Apps from your avatar menu and create an API key.
- Copy the key — you will not be able to see it again.
Claude Code
Add this to your .mcp.json:
{
"mcpServers": {
"polyhedral": {
"type": "url",
"url": "https://polyhedral.co/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}Cursor / Windsurf
Same configuration format — add to your project or global MCP settings:
{
"mcpServers": {
"polyhedral": {
"type": "url",
"url": "https://polyhedral.co/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}Available Tools
- Games — list, get, create, update, invite, list members
- Notes — list, get, create, update, delete, search
- Library — list resources, get resource, get page, search, update visibility
- Chat — get history, send message
- Dice — roll dice with standard RPG notation
- Rollable Tables — list, get, create, update, delete, roll on table
- Encounters — list, get, create, update, delete
- Sheets — list templates, list/get/create/update instances
- Maps — list maps, get map, get active map, list tokens
Resources
The server also exposes MCP resources for browsing game data:
- polyhedral://games
- polyhedral://games/{gameId}/notes
- polyhedral://games/{gameId}/notes/{noteId}
- polyhedral://games/{gameId}/library
- polyhedral://games/{gameId}/library/{resourceId}
- polyhedral://games/{gameId}/chat/recent