Skip to main content
Glama
plurity-ai

plurity-mcp

Official
by plurity-ai
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

Related MCP server: guardrails-mcp-server

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 (the site key is only ever returned by get_toll_installation_instructions)

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)

list_toll_events

Row-level events with UTM/host filters (visitor-identifying fields are redacted)

get_toll_llms_txt

Fetch the currently served llms.txt body

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Peta Core

    dunialabs
    F
    license
    Not graded
    quality
    A
    maintenance
    A production-ready MCP gateway and control plane that provides credential vault, policy engine, audit logging, and managed runtime for routing tool calls between AI agents and downstream MCP servers.
    58
    -

  • guardrails-mcp-server

    ExpertVagabond
    A
    license
    Not graded
    quality
    B
    maintenance
    MCP server for AI agent security guardrails. Provides input validation, prompt injection detection, PII redaction, output filtering, policy enforcement, rate limiting, and comprehensive audit logging.
    42 npm
    1
    MIT

  • Multi-Provider LLM MCP Server

    itachiuchihadev
    F
    license
    A
    quality
    B
    maintenance
    Unified MCP server for querying multiple LLM providers (Gemini, OpenAI, Anthropic, etc.) with advanced routing, cost optimization, and fallback resilience.
    2
    6 npm
    -

  • devops-mcp

    NotHarshhaa
    A
    license
    B
    quality
    C
    maintenance
    Unified MCP server for DevOps engineers that provides real-time read and write access to Kubernetes, ArgoCD, Prometheus, and PagerDuty from any MCP-compatible AI agent.
    21
    73 npm
    3
    MIT