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

Project links

Data verified by PyPI on Jul 26, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.4)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ryugoron from gravatar.com ryugoron

GitHub Statistics

Data verified by PyPI on Jul 26, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.12

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

plurity_mcp-0.1.2.tar.gz (18.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

plurity_mcp-0.1.2-py3-none-any.whl (23.0 kB view details)

Uploaded Python 3

File details

Details for the file plurity_mcp-0.1.2.tar.gz.

File metadata

  • Download URL: plurity_mcp-0.1.2.tar.gz
  • Upload date:
  • Size: 18.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for plurity_mcp-0.1.2.tar.gz
Algorithm Hash digest
SHA256 6f040c1ebb7f80d6a139418fa005f00db6330688a726362bbeb281b121d99332
MD5 ea16441b0d5d1bac7fb923f82192cad5
BLAKE2b-256 9dc79f8772fa17a7268871d63eed9400add2618647a597cdcce07383c6594c7f

See more details on using hashes here.

Provenance

The following attestation bundles were made for plurity_mcp-0.1.2.tar.gz:

Publisher: publish.yml on plurity-ai/plurity-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file plurity_mcp-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: plurity_mcp-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 23.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for plurity_mcp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6412d05f4ed0e4600a5c55798a0fa9876bc769d22e250286ca948812ad0d8e64
MD5 d0431e04df9f1fb4a2ad9ee19f65a2dc
BLAKE2b-256 f9b9e6cb02c489a2e6528411f6da8af400a28b2d3ef2a7969dfc781c1802b9ca

See more details on using hashes here.

Provenance

The following attestation bundles were made for plurity_mcp-0.1.2-py3-none-any.whl:

Publisher: publish.yml on plurity-ai/plurity-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.4

2 files

This release

0.1.2 This release

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page