plurity-mcp

Unified MCP server for all Plurity services — Audit, Toll, and Intelligence — using a single API key.

Installation

uvx plurity-mcp

Or install permanently:

uv tool install plurity-mcp

Quick start

1. Get an API key

Log in to account.plurity.ai → Settings → API Keys → Create key. Grant the scopes for each service you want to use (audit, toll, intelligence).

2. Run the setup wizard

plurity-mcp-setup

The wizard validates your key and saves it to ~/.config/plurity/config.toml.

3. Add to your MCP client

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "plurity": {
      "command": "uvx",
      "args": ["plurity-mcp"],
      "env": {
        "PLURITY_API_KEY": "plt_your_key_here"
      }
    }
  }
}

Configuration

Environment variables

Config file (~/.config/plurity/config.toml)

[mcp]
api_key = "plt_..."
accounts_url = "https://account.plurity.ai"
audit_base_url = "https://audit.plurity.ai"
toll_base_url = "https://toll.plurity.ai"
intelligence_base_url = "https://intelligence.plurity.ai"
audit_enabled = true
toll_enabled = true
intelligence_enabled = true

Environment variables take precedence over the config file.

Service activation

On startup the server:

1. Validates your API key against plurity-accounts
2. Reads the key's scopes (e.g. ["audit", "toll"])
3. Registers only the tools for services the key is scoped for
4. Applies your *_ENABLED overrides — you can disable services the key has access to, but you cannot enable services the key lacks a scope for

If the key is invalid the server exits immediately with a clear error message visible in your MCP client.

Tools

Audit (GEO readiness)

Toll (agent traffic + llms.txt)

Intelligence (question & topic monitoring)

Development

git clone https://github.com/plurity-oss/plurity-mcp
cd plurity-mcp
uv sync
uv run plurity-mcp-setup    # set up key
uv run plurity-mcp          # run locally

License

MIT