How should agents-council be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this mcp.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Crawler Summary

agents-council answer-first brief

Agent-to-Agent MCP communication tool for feedback requests <p align="center"> <img src="./.github/agents-council.jpg" alt="Agents Council" width="1280" height="714" /> </p> <h1 align="center">Agents Council</h1> <p align="center"><strong>The simplest way to bridge and collaborate across AI Agent sessions</strong></p> <p align="center"> Status: <code>Experimental</code> </p> --- 🏛️ Overview Designed for developers who already have active agent sessions and want them to colla Published capability contract available. No trust telemetry is available yet. 20 GitHub stars reported by the source. Last updated 2/24/2026.

Freshness

Last checked 2/22/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

agents-council is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

Card Facts Snapshot Contract Trust

Claim this agent

Agent DossierGitHubSafety: 100/100

agents-council

MCPverified

Public facts

Change events

Artifacts

Freshness

Feb 22, 2026

Verifiededitorial-content1 verified compatibility signal20 GitHub stars

Published capability contract available. No trust telemetry is available yet. 20 GitHub stars reported by the source. Last updated 2/24/2026.

20 GitHub starsSchema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Feb 22, 2026

Vendor

Mrlesk

Artifacts

Benchmarks

Last release

0.4.0

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. 20 GitHub stars reported by the source. Last updated 2/24/2026.

View Source

Setup snapshot

git clone https://github.com/MrLesk/agents-council.git

1
Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content

Vendor (1)

Vendor

Mrlesk

profilemedium

Observed Feb 24, 2026Source link Provenance

Compatibility (2)

Protocol compatibility

MCP

contracthigh

Observed Feb 24, 2026Source link Provenance

Auth modes

mcp, api_key

contracthigh

Observed Feb 24, 2026Source link Provenance

Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh

Observed Feb 24, 2026Source link Provenance

Adoption (1)

Adoption signal

20 GitHub stars

profilemedium

Observed Feb 24, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB MCP

Extracted files

Examples

Snippets

Languages

typescript

Executable Examples

bash

npm install -g agents-council

bash

claude mcp add council npx agents-council@latest mcp

bash

claude mcp add council -s user -- npx agents-council@latest mcp -n Opus

bash

gemini mcp add council npx agents-council@latest mcp

bash

codex mcp add council npx agents-council@latest mcp

bash

amp mcp add council npx agents-council@latest mcp

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB MCP

Docs source

GITHUB MCP

Editorial quality

ready

Full README

<p align="center"> <img src="./.github/agents-council.jpg" alt="Agents Council" width="1280" height="714" /> </p> <h1 align="center">Agents Council</h1> <p align="center"><strong>The simplest way to bridge and collaborate across AI Agent sessions</strong></p> <p align="center"> Status: <code>Experimental</code> </p>

🏛️ Overview

Designed for developers who already have active agent sessions and want them to collaborate without extra infrastructure.

Agents Council is the simplest way to bridge and collaborate across AI Agent sessions like Claude Code, Codex, Gemini, Cursor or others. It allows your agents to combine their strengths to solve your most difficult tasks without leaving their current context.

The most powerful way to use the council is by connecting your existing, active sessions. You can initialize them with the specific context you want, let them brainstorm or peer-review the matter, and then seamlessly take over the session once the council has finished.

Inspired by Andrej Karpathy's LLM Council, it provides an MCP-based CLI tool that lets multiple agents communicate with each other and find solutions to your most complex tasks.

✨ Features

Centralized agent communication via MCP stdio server (no complex peer-to-peer networking).
Summon Claude or Codex: Instantly summon Claude or Codex into your council when needed. Reuses local CLI authentication where available.
Session Preservation: Start agents with your specific context, let them collaborate, and resume when they are done.
Human Participation: A local chat UI to monitor or join the discussion.
Private & Local: State is stored on disk at ~/.agents-council/state.json.
Flexibility: Markdown or JSON text output for agent readability or automation.

🚀 Getting Started

Agents Council requires Node.js or Bun.

1. MCP Mode (Zero Install)

No installation is needed when using only the MCP mode. You can add the agents council MCP server to your agents using npx (or bunx). See the MCP Setup section below for specific commands.

If you only need agent-to-agent communication, skip to MCP Setup. Install the CLI only for the web UI or global council command.

2. Web Interface & CLI

If you want to participate via the web interface or use the council command globally, install the package:

npm install -g agents-council

Then run council chat to start the local web interface in your browser.

🔌 MCP Setup

Add the council to your favorite MCP client using the commands below.

<details> <summary>Claude Code</summary> Use the Claude Code CLI to add the Agents Council MCP server (<a href="https://docs.anthropic.com/en/docs/claude-code/mcp">guide</a>):

claude mcp add council npx agents-council@latest mcp

or use a predefined Agent Name:

claude mcp add council -s user -- npx agents-council@latest mcp -n Opus

</details> <details> <summary>Gemini CLI</summary> Use the Gemini CLI to add the Agents Council MCP server (<a href="https://geminicli.com/docs/tools/mcp-server/#adding-a-server-gemini-mcp-add">guide</a>):

gemini mcp add council npx agents-council@latest mcp

</details> <details> <summary>Codex</summary> Use the Codex CLI to add the Agents Council MCP server (<a href="https://developers.openai.com/codex/mcp/#add-a-mcp-server">guide</a>):

codex mcp add council npx agents-council@latest mcp

</details> <details> <summary>amp</summary> Use the amp CLI to add the Agents Council MCP server (<a href="https://ampcode.com/manual#mcp">guide</a>):

amp mcp add council npx agents-council@latest mcp

</details> <details> <summary>Other MCP integrations</summary>

{
  "mcpServers": {
    "council": {
      "command": "npx",
      "args": [
        "agents-council@latest",
        "mcp"
      ]
    }
  }
}

</details>

📖 Quick Start

Start a council session in one terminal (e.g. via Claude Code) and describe the complex topic you need help with.
Join the council from another terminal (e.g. via Codex or Gemini) to provide feedback.
Review feedback and take over the session once the council has provided enough insights.

💬 Chat UI

Run the local web interface for human participants:

council chat

The chat UI runs on localhost and follows the Council Hall redesign:

Council Sidebar: session chronicle, session spawn action, and archive area.
Council Hall: active session header, voice stream, composer, and summon entry point.

The summon workflow is part of the Hall interface. Model and agent selections persist in ~/.agents-council/config.json.

UI implementation and future UI feature work should follow docs/ui-spec.md and docs/ui-implementation-progress.md.

🪄 Summon Agents

The Summon feature lets you bring a Claude or Codex agent into the active Council Hall session. Summoned agents review the matter and prior feedback, then contribute their response to the same voice stream.

Summon Claude

Prerequisites:

Claude Code must be installed and available in your PATH
Run claude at least once to authenticate

How it works:

A summoned Claude agent joins the active council session
It reads the current request and any prior feedback
It contributes a response using the council tools
The agent is granted read-only access to the project (Read/Glob/Grep) plus council tools
Other tools follow your Claude Code user permission settings

Advanced Configuration:

These settings are optional. By default, Agents Council looks for claude in your PATH.

| Setting | Default | Description | |---------|---------|-------------| | Claude Code Path (Settings UI) | claude | Custom path to the Claude Code executable | | CLAUDE_CODE_PATH (env var) | claude | Alternative way to set the path | | AGENTS_COUNCIL_SUMMON_DEBUG | (unset) | Set to 1 to enable debug logging |

Summon Codex

Prerequisites:

Run codex login once (authentication is handled by the Codex SDK/CLI)
Optional: set a default model in ~/.codex/config.toml (for example, model = "gpt-5.2-codex")

How it works:

A summoned Codex agent reads the current request and any prior feedback
It returns a single response that is recorded in the council
Codex runs via the Codex SDK CLI in read-only mode by default

Advanced Configuration:

Authentication is handled by the Codex SDK/CLI (typically codex login). If your Codex setup uses API keys or a custom base URL, those will still be honored.

These settings are optional. By default, Agents Council uses the bundled Codex CLI from the SDK.

| Setting | Default | Description | |---------|---------|-------------| | Codex CLI Path (Settings UI) | bundled | Custom path to the Codex CLI executable | | CODEX_PATH (env var) | (unset) | Alternative way to set the path |

🛠️ MCP Tools

start_council: Open a session with a request.
join_council: Fetch the request and responses for first-time participants.
get_current_session_data: Poll for new responses (supports cursors).
send_response: Submit feedback.
close_council: End the session with a conclusion.
summon_agent: Summon Claude or Codex into the current council.

🗺️ Roadmap

Unchecked items are planned and may change based on feedback.

[x] v0.1 - MCP Council
[x] v0.2 - Chat UI
[x] v0.3 - Summon Claude
[x] v0.4 - Summon Codex
[ ] v0.5 - Summon Gemini
[ ] v0.6 - Multiple council sessions in parallel
[ ] v0.7 - Connect to external LLMs via API Keys
[ ] v0.8 - Agents can summon user (Telegram/Slack)

📄 License

MIT

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

ready

Auth

mcp, api_key

Streaming

Yes

Data region

global

Protocol support

MCP: verified

Requires: mcp, lang:typescript, streaming

Forbidden: high_risk

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.

Trust confidence is not low and verification freshness is acceptable.

Protocol support is explicitly confirmed in contract metadata.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/snapshot"

curl -s "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/contract"

curl -s "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media

No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors

GITLAB_AI_CATALOGgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_PUBLIC_PROJECTSgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-openapi

Rank

Expose OpenAPI definition endpoints as MCP tools using the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-actix-web

Rank

An actix_web backend for the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "mcp",
    "api_key"
  ],
  "requires": [
    "mcp",
    "lang:typescript",
    "streaming"
  ],
  "forbidden": [
    "high_risk"
  ],
  "supportsMcp": true,
  "supportsA2a": false,
  "supportsStreaming": true,
  "inputSchemaRef": "https://github.com/MrLesk/agents-council#input",
  "outputSchemaRef": "https://github.com/MrLesk/agents-council#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:45:38.928Z",
  "sourceUpdatedAt": "2026-02-24T19:45:38.928Z",
  "freshnessSeconds": 4421991
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_MCP",
      "generatedAt": "2026-04-17T00:05:30.099Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "supported",
      "confidenceSource": "contract",
      "notes": "Confirmed by capability contract"
    },
    {
      "key": "mcp",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "council",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "agents",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "cli",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "mcp-server",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|supported|contract capability:mcp|supported|profile capability:council|supported|profile capability:agents|supported|profile capability:cli|supported|profile capability:mcp-server|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP",
    "href": "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:45:38.928Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "mcp, api_key",
    "href": "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:45:38.928Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/MrLesk/agents-council#input",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:45:38.928Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Mrlesk",
    "href": "https://github.com/MrLesk/agents-council",
    "sourceUrl": "https://github.com/MrLesk/agents-council",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "traction",
    "category": "adoption",
    "label": "Adoption signal",
    "value": "20 GitHub stars",
    "href": "https://github.com/MrLesk/agents-council",
    "sourceUrl": "https://github.com/MrLesk/agents-council",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-mrlesk-agents-council/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]