# Plures MCP server

> Enables AI agents to request human verification from ID-verified people for high-stakes decisions using an ask_humans tool.

- Repository: https://github.com/plureslabs/plures
- Page: https://hostedmcp.org/servers/plureslabs/plures
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 1.11.1

## Install

### Claude Code

```sh
claude mcp add --env 'PLURES_API_KEY=<YOUR_PLURES_API_KEY>' plures -- npx -y plures-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "plures": {
      "command": "npx",
      "args": [
        "-y",
        "plures-mcp"
      ],
      "env": {
        "PLURES_API_KEY": "<YOUR_PLURES_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "plures": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "plures-mcp"
      ],
      "env": {
        "PLURES_API_KEY": "<YOUR_PLURES_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"plures","type":"stdio","command":"npx","args":["-y","plures-mcp"],"env":{"PLURES_API_KEY":"<YOUR_PLURES_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "plures": {
      "command": "npx",
      "args": [
        "-y",
        "plures-mcp"
      ],
      "env": {
        "PLURES_API_KEY": "<YOUR_PLURES_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add plures --env 'PLURES_API_KEY=<YOUR_PLURES_API_KEY>' -- npx -y plures-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.plures]
command = "npx"
args = ["-y", "plures-mcp"]

[mcp_servers.plures.env]
PLURES_API_KEY = "<YOUR_PLURES_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'PLURES_API_KEY=<YOUR_PLURES_API_KEY>' plures npx -- -y plures-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "plures": {
      "command": "npx",
      "args": [
        "-y",
        "plures-mcp"
      ],
      "env": {
        "PLURES_API_KEY": "<YOUR_PLURES_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `PLURES_API_KEY` | yes | yes | Your Plures API key. A free pk_test_ key works for trying it. |
| `PLURES_BASE_URL` | no | no | API base URL, defaults to https://plures.si |

## Tools (15)

- `ask_humans`: Send a decision to ID verified people before you act on it. Several people answer independently, each confirmed with Face ID, and you get back the consensus answer and how strongly they agreed. Use it for judgment calls where being wrong is costly: evals of AI output, tone and intent, whether two things match, moderation edge cases. Send refunds, payments and other money calls with route team. Write the question so a stranger can answer it from the context alone, and never include secrets or more personal data than the decision needs. Live keys use prepaid credit at $0.20 per answer (clips cost more by length), or $0.05 per internal vote with route team; test keys are free and simulated.
- `ask_judgment`: Ask a panel of ID verified people for their honest view when there's no right answer to check: which of two replies, designs, headlines or model answers is better, whether a customer would accept a reply or decision, how well something meets a brief (1 to 5), or whether a design, video or generated image has a flaw. You get the spread of views, a contested flag when people genuinely split, and a sample of one line reasons. format signoff (coming soon; test keys now) asks one top rated verified person to approve or reject an action after a fresh Face ID or Touch ID check, with a written reason: use it before an action someone must be accountable for. Live keys use prepaid credit at $0.20 per answer (a panel of 5 is $1.00) or $1.00 per sign off; test keys are free and simulated.
- `audit_my_agent`: Sends a Plures audit: up to 50 decisions an AI agent already made, graded so the developer sees which were wrong. The account's first audit is free. After it has finished, each further audit is paid from the account's credit when it is sent: $0.20 a decision, or $0.50 for kind judgment, so tell the developer the cost and get their yes before sending a second one. One audit at a time. Works with a test or live key. Each row is input (what the agent saw, including the policy it should follow) and decision (what it did). Gather them from the developer's logs, database or test fixtures; leave out names and other private details (emails, phones and card numbers are removed anyway). kind check (default) asks whether each call was right (the dashboard calls it the accuracy audit); kind judgment asks whether a customer would be happy with it (the quality audit). Text only: to have an image, video or audio clip judged, the developer sends a quality audit from plures.si/dashboard/audit with a media column. A person at Plures reviews it before anyone grades it. Use get_audit_report to read the results.
- `get_audit_report`: Reads the developer's Plures audit: where it is, and once people are answering, how many decisions they called right, wrong, unclear or split, with the ones they disagreed with listed first. For judgment audits: right means people would be happy with it, wrong means not happy, unclear means it needs changes. (read-only)
- `find_precedents`: Searches the developer's judgment graph: past decisions people made on cases like this one, closest first, with the answer and how strongly they agreed. Returns a suggestion only when the case is settled: several close cases with the same options, all decided the same way with strong agreement. Free. To act on a settled case and have it recorded and billed as a decision, call ask_humans with use_precedent instead. (read-only)
- `get_scorecard`: Returns whether precedents and taste are working for this account: precedent accuracy from spot checks, share of decisions answered by precedent, decisions right the first time, taste false alarms, and the time and cost of a decision. Each number comes with how many decisions it rests on; one marked early is a hint, not a fact. Also shows the precedent settings and any change Plures is suggesting. Read only: a person changes settings and answers suggestions in the dashboard. Free. (read-only)
- `get_taste`: Returns what this team wants its agents' work to look like: the standing rules in force and recent examples of what they like and don't. Call it before producing work the team will judge, and follow the rules. Pass category for one kind of work; rules that apply to everything are always included. Free. (read-only)
- `check_against_taste`: Holds a draft up against the team's rules and examples before a person sees it, and says which rules it breaks and why. Send the text, a public https image link, or both. Fix what it reports, then ask a person if the work still needs one. Free. (read-only)
- `add_taste_rule`: Saves a standing rule for this team's agents, in force at once. Use it only when the user states a preference that should hold from now on, and confirm the wording with them first. One plain sentence.
- `add_taste_example`: Saves something the team likes or doesn't, so their agents can take it into account: an image by public https link, or a piece of text, with an optional note on why. Plures describes and tags it.
- `get_human_answer`: Check on a task sent with ask_humans and return the verified people's answer once it's ready. (read-only)
- `cancel_human_task`: Cancel a task that is still waiting for answers, for example when the decision no longer matters. Answers already given are still billed.
- `get_mapping_guide`: Returns the steps for mapping the developer's AI agent for Plures: how to find its steps and actions, where to suggest a person checks, and how to draft each check. Call this first when asked to map an app for Plures. (read-only)
- `submit_agent_map`: Uploads the map you made with get_mapping_guide: nodes, edges and checkpoints with drafted checks. Never include source code, secrets or customer data. If Plures names a problem, fix it and send again.
- `get_agent_map`: Returns an app's agent map from Plures: its checkpoints, which are added, and live numbers for each (checks in 30 days, agreement, how many went to the team). (read-only)

## FAQ

### How much does it cost to use Plures with real people?

A pk_live_ key sends tasks to real verified people at a cost of $0.20 per answer, with higher rates for recordings and videos based on length.

### Can I send sensitive decisions to my own team instead of strangers?

Yes, you can use the route: "team" parameter to send decisions regarding money, accounts, or confidential policy calls directly to your own team.

### What happens if people don't answer within the time limit?

If the wait period expires, the tool returns a task_id that you can use to check the status later.

### Is there a way to test the server for free?

Yes, using a pk_test_ key will provide an instant simulated result for free so you can test the flow.
