PCIndex MCP

Connect an agent to PCIndex

The website is the public terminal. The hosted MCP endpoint gives agents read access; trusted operators can run the local connector when they need evidence intake.

Recommended today

Use hosted read access; keep writes local.

External agents can read PCIndex directly from the hosted MCP URL. Registry-changing tools stay in the configured local runtime until authentication and review controls are added.

Hosted read MCP: liveLocal write MCP: ready

Quick start

Hosted read connector

  1. Add PCIndex.Register the hosted MCP URL in your agent client.
  2. Use read tools.Ask for policies, PCI state, dossiers, or evidence traces.
  3. Keep intake local.Write-capable evidence intake remains operator-only.
Claude Code
claude mcp add -s user -t http pcindex https://pcindex.vercel.app/mcp
Codex CLI
codex mcp add pcindex --url https://pcindex.vercel.app/mcp

Current setup

What is live

Use nowLive

Hosted read MCP

Works from MCP clients that support Streamable HTTP. Exposes read-only policy and evidence tools.

https://pcindex.vercel.app/mcp
Trusted operatorsReady

Local write MCP

Runs from the repository checkout and keeps evidence intake inside the configured PCIndex runtime.

uv run --extra dev python -m pci_realtime.mcp_server

Tool surface

Functions the agent gets

1
status()read

Check registry reachability and connector readiness.

2
list_policies()read

Return the six tracked IRA policy units.

3
current_pci(code?)read

Read the current PCI score for one policy or all policies.

4
policy_dossier(code)read

Read policy events, evidence rows, and registry state.

5
get_evidence_trace(provision, evidence_id?)read

Verify source links and evidence that entered the registry.

Manual config

Generic hosted config

Use this when your agent client accepts remote MCP server JSON.

Generic hosted MCP config
{
  "mcpServers": {
    "pcindex": {
      "serverUrl": "https://pcindex.vercel.app/mcp"
    }
  }
}

Evidence intake

Local write connector

Use this only for trusted operators who need to submit cited evidence into the registry.

Get PCIndex
git clone https://github.com/yudduy/pci-realtime && cd pci-realtime && uv sync --extra dev
Claude Code local
claude mcp add -s user pcindex -- bash -lc "cd \"$(pwd)\" && uv run --extra dev python -m pci_realtime.mcp_server"
Codex CLI local
codex mcp add pcindex -- bash -lc "cd \"$(pwd)\" && uv run --extra dev python -m pci_realtime.mcp_server"
Generic local MCP config
{
  "mcpServers": {
    "pcindex": {
      "command": "bash",
      "args": [
        "-lc",
        "cd \"$(pwd)\" && uv run --extra dev python -m pci_realtime.mcp_server"
      ]
    }
  }
}