# Agoragentic Agent OS MCP

Agoragentic puts a policy and approval boundary around your agent, then keeps evidence of what it did and why the outcome was recorded.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 41
- Author: Agoragentic
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Agoragentic/agoragentic-integrations
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/agoragentic-agent-os-mcp

## What it does

The server plugs into Claude, Claude, Cursor, GitHub Copilot, Windsurf, Cline and Zed, and sits on top of the runtime you already run. No rewrite is required: it works alongside LangGraph, CrewAI, Anthropic Agents, MCP, or your own Python and Node.js code. What comes out is a policy decision, an approval record, lifecycle events and a local receipt.

Claude Code gets a packaged `PreToolUse` hook with allow, ask and deny verdicts. It settles the pre-tool decision; it does not prove that every downstream side effect finished correctly. For other hosts you get mapping examples and adapter contracts, and a mapping is not in-path enforcement.

The local Harness Core route needs no account, wallet or paid runtime. Keep in mind that the task string only labels a run — it is not proof the host executed anything. Live enforcement requires a supported host hook or an integration around Harness middleware. The stdio variant expects `AGORAGENTIC_API_KEY`, `AGORAGENTIC_MCP_URL` and `AGORAGENTIC_BASE_URL`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://agoragentic.com/api/mcp`
- Environment variables: `AGORAGENTIC_API_KEY`, `AGORAGENTIC_MCP_URL`, `AGORAGENTIC_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http agoragentic https://agoragentic.com/api/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env AGORAGENTIC_API_KEY=<AGORAGENTIC_API_KEY> --env AGORAGENTIC_MCP_URL=<AGORAGENTIC_MCP_URL> --env AGORAGENTIC_BASE_URL=<AGORAGENTIC_BASE_URL> --transport stdio agoragentic-agent-os-mcp -- npx -y agoragentic-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add agoragentic-agent-os-mcp --url https://agoragentic.com/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add agoragentic-agent-os-mcp --env AGORAGENTIC_API_KEY=<AGORAGENTIC_API_KEY> --env AGORAGENTIC_MCP_URL=<AGORAGENTIC_MCP_URL> --env AGORAGENTIC_BASE_URL=<AGORAGENTIC_BASE_URL> -- npx -y agoragentic-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agoragentic-agent-os-mcp": {
            "url": "https://agoragentic.com/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agoragentic-agent-os-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "agoragentic-mcp"
            ],
            "env": {
                "AGORAGENTIC_API_KEY": "<AGORAGENTIC_API_KEY>",
                "AGORAGENTIC_MCP_URL": "<AGORAGENTIC_MCP_URL>",
                "AGORAGENTIC_BASE_URL": "<AGORAGENTIC_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agoragentic-agent-os-mcp": {
            "type": "http",
            "url": "https://agoragentic.com/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agoragentic-agent-os-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "agoragentic-mcp"
            ],
            "env": {
                "AGORAGENTIC_API_KEY": "<AGORAGENTIC_API_KEY>",
                "AGORAGENTIC_MCP_URL": "<AGORAGENTIC_MCP_URL>",
                "AGORAGENTIC_BASE_URL": "<AGORAGENTIC_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http agoragentic-agent-os-mcp https://agoragentic.com/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e AGORAGENTIC_API_KEY=<AGORAGENTIC_API_KEY> -e AGORAGENTIC_MCP_URL=<AGORAGENTIC_MCP_URL> -e AGORAGENTIC_BASE_URL=<AGORAGENTIC_BASE_URL> agoragentic-agent-os-mcp npx -y agoragentic-mcp
```
Replace <…> with your own values

## When to use it
- bound what an agent may do before a tool call
- keep inspectable evidence of agent actions
- record who approved a consequential action
- produce local receipts for a no-spend run
- attach an existing agent to a governed runtime without a rewrite

## Example prompts
- Add the agoragentic-agent-os-mcp server over HTTP and list the available policies
- Run Harness Core with the local_no_spend profile and show me `local-proof.json`
- Set up the `PreToolUse` hook so risky calls need approval

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md