Skip to main content
Glama
plurity-ai

plurity-mcp

Official
by plurity-ai

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

Variable

Default

Description

PLURITY_API_KEY

Your plt_* API key (required)

PLURITY_ACCOUNTS_URL

https://account.plurity.ai

Override accounts API URL

PLURITY_AUDIT_URL

https://audit.plurity.ai

Override Audit API URL

PLURITY_TOLL_URL

https://toll.plurity.ai

Override Toll API URL

PLURITY_INTELLIGENCE_URL

https://intelligence.plurity.ai

Override Intelligence API URL

PLURITY_AUDIT_ENABLED

true

Set to false to disable Audit tools

PLURITY_TOLL_ENABLED

true

Set to false to disable Toll tools

PLURITY_INTELLIGENCE_ENABLED

true

Set to false to disable Intelligence tools

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)

Tool

Description

submit_audit_scan

Queue a URL for AI-readiness analysis

get_audit_scan

Get scan status and results by ID

get_audit_scan_by_url

Look up the latest scan for a URL

run_audit

Submit and wait until complete (blocking)

Toll (agent traffic + llms.txt)

Tool

Description

list_toll_sites

List your sites/pages

create_toll_site

Create a new site

get_toll_site

Get site details including site key

update_toll_site

Update name, domain, cache TTL, llms.txt mode

get_toll_installation_instructions

Get integration code snippets for HTML/Next.js/React/GTM

list_toll_qa_pairs

List Q&A pairs in a site's llms.txt

create_toll_qa_pair

Add a Q&A entry to llms.txt

update_toll_qa_pair

Edit a Q&A entry (or publish/unpublish it)

delete_toll_qa_pair

Remove a Q&A entry

get_toll_traffic

Agent traffic chart data (today/week/month/year)

Intelligence (question & topic monitoring)

Tool

Description

list_intelligence_sources

Browse the global source catalogue

list_subscribed_intelligence_sources

List sources your org follows

subscribe_intelligence_source

Subscribe to a source

unsubscribe_intelligence_source

Unsubscribe from a source

request_intelligence_source

Add a new source by URL (auto-subscribes)

list_intelligence_source_content

List raw scraped documents

list_intelligence_qa_pairs

Browse the Q&A feed with filters

approve_intelligence_qa_pair

Move a Q&A pair into your knowledge base

skip_intelligence_qa_pair

Dismiss a Q&A pair from the feed

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

A
license - permissive license
-
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/plurity-ai/plurity-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server