Polis Protocol — Claude Code MCP server: what it does, how to install
A local coordination plane for multiple coding agents in one repository. It routes tasks by actual track records and logs progress in Markdown.
claude mcp add polis-protocol -- uvx polis-protocolWhat Polis Protocol does
The server lets multiple coding assistants (Claude, Codex, Gemini, Cursor) collaborate inside one Git repository. Everything lives in local files under _polis/. Task contracts and the chronicle.md audit trail remain in plain Markdown, without any remote database.
Task dispatching relies on a multi-armed bandit algorithm. The router checks capability profiles and verified outcomes. Work goes to the agent with the strongest track record, ignoring self-promotional ratings.
Running the server with uvx requires Python 3.10+. Projects must first be initialized using uvx polis-protocol init, because agents cannot log agreements without the local directory structure in place.
What it helps with
- coordinate multiple AI assistants in a shared Git workspace
- route incoming issues to agents based on demonstrated track records
- record retrospective lessons to avoid repeating prior task failures
- maintain a transparent event log inside plain Markdown files
Example prompts for the agent
- Inspect
_polis/chronicle.mdto see recent agent assignments - Draft a new contract for database migrations with capability tags
- Select the best model for a Spanish localization task
How to install Polis Protocol
Platform CLI
claude mcp add polis-protocol -- uvx polis-protocoluvx runs the command named after the package; if the README names another one, use uvx --from polis-protocol <command>
Platform CLI
codex mcp add polis-protocol -- uvx polis-protocoluvx runs the command named after the package; if the README names another one, use uvx --from polis-protocol <command>
Config file
{
"mcpServers": {
"polis-protocol": {
"command": "uvx",
"args": [
"polis-protocol"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from polis-protocol <command>
Config file
{
"servers": {
"polis-protocol": {
"type": "stdio",
"command": "uvx",
"args": [
"polis-protocol"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from polis-protocol <command>
Platform CLI
gemini mcp add polis-protocol uvx polis-protocoluvx runs the command named after the package; if the README names another one, use uvx --from polis-protocol <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Polis Protocol
How to install Polis Protocol in Claude Code?
Run claude mcp add polis-protocol -- uvx polis-protocol in your terminal. You should also run uvx polis-protocol init in your project root.
What does Polis Protocol do?
It provides local orchestration for coding agents working in the same repository. The system balances tasks using empirical performance and records project history in Markdown files.
Does Polis Protocol require a central server?
No central server or database is involved. All task contracts, state updates, and chronicle logs reside directly in your repository folder.
