# P31 Governed Agent CLI

> P31 Governed Agent CLI is an open-source MCP server for developer tools. Command-line agent with a 133-tool MCP server for neurodivergent-friendly workflows. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/p31labs/p31-cli
- **MCP Registry name:** org.p31ca/governed-agent-cli
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

P31 CLI is a TypeScript command-line program (Node 22 or newer) that runs as an interactive terminal app, a one-shot chat, an autonomous agent mode, or an MCP server over stdio or HTTP. The README describes it as an agent for neurodivergent families, styled on OpenCode, with a spoon-aware interface that adapts to energy levels.

Its MCP server groups 133 tools into ten categories, among them a cognitive-support set of 47, ground-truth fact tools, design-compliance and design-token tools, a 3-gate verification set and a session-state set. It supports Anthropic, Google Gemini and OpenRouter models, stores sessions in SQLite, and ships three accessible themes with large touch targets. The registry entry also mentions signed provenance exports and WCAG-validated themes.

The README documents only a few environment variables and gives little detail on individual tools, so check the repository before depending on a specific one.

## Features

- **Multiple run modes:** Runs as a TUI, one-shot chat, autonomous agent or MCP server.
- **133 MCP tools:** Groups tools into ten categories such as cognitive, ground-truth and design.
- **Three LLM providers:** Works with Anthropic, Google Gemini and OpenRouter.
- **Spoon-aware interface:** Adapts the terminal UI to a user's energy level.
- **Accessible themes:** Provides three themes using Atkinson Hyperlegible and large touch targets.
- **SQLite sessions:** Keeps session history in SQLite with per-tree sharding.

## Good for

- Run an accessible terminal assistant for a family member
- Expose a design-token and compliance toolset to an MCP client
- Check generated designs against accessibility rules
- Keep verified facts available to an agent
- Manage sessions and sync across apps from the CLI

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http governed-agent-cli https://mcp.p31ca.org/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.p31ca.org/mcp
```

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

```json
{
  "mcpServers": {
    "governed-agent-cli": {
      "url": "https://mcp.p31ca.org/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "governed-agent-cli": {
      "type": "http",
      "url": "https://mcp.p31ca.org/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "governed-agent-cli": {
      "serverUrl": "https://mcp.p31ca.org/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "governed-agent-cli": {
      "type": "http",
      "url": "https://mcp.p31ca.org/mcp"
    }
  }
}
```

## FAQ

### How do I install it?

Use the curl install script from cli.p31ca.org, or clone the repo, run npm install, npm run build and npm link.

### Which transports are available?

Stdio through p31 mcp and HTTP through p31 mcp:http, plus a hosted endpoint in the registry.

### What licence is it under?

MIT, by P31 Labs.

### What Node version is needed?

Node.js 22 or newer.

### Is P31 Governed Agent CLI free?

Yes. P31 Governed Agent CLI is open source, so you can use and self-host it for free.

### How do I add P31 Governed Agent CLI to Claude Code?

Run this command in your terminal: claude mcp add --transport http governed-agent-cli https://mcp.p31ca.org/mcp

### What are the best alternatives to P31 Governed Agent CLI?

The closest alternatives to P31 Governed Agent CLI are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/p31-governed-agent-cli
