About AI Counsel
AI Counsel is an MCP server published by blueman82 in the AI category: true deliberative consensus MCP server where AI models debate and refine positions across multiple rounds.
The repository has 1 stars and 2 forks, with the last commit 7 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
From source
git clone https://github.com/blueman82/ai-counselThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
✦
Ask AI about AI Counsel
Powered by Claude · Grounded in docs
I know everything about AI Counsel. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
Static checks derived from the repository 7 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
v1.11.0v1.11.0 · 10 Oct 2026| Changes | Evidence | |---|---| | MCP 1.x compatibility; explicit dotenv dependency | #49 | | Enabled-registry summaries; bounded free-model fallback; Retry-After and shared pacing | #49 | | Provider usage, estimated cost comparisons,…
v1.10.1v1.10.1 · 6 May 2026Changes Update model registry to latest frontier only + expand effort levels Claude: claude-opus-4-7 (default), claude-sonnet-4-6, claude-haiku-4-5 Codex: gpt-5.5 only Expanded reasoning effort levels: none/minimal/low/medium/high/xhigh…
v1.10.0v1.10.0 - Opus 4.6 + GPT-5.3 Codex Support · 15 Feb 2026What's New New Models Claude Opus 4.6 — New default premium Claude model (registry id: `opus`) GPT-5.3 Codex — New default flagship Codex model Claude Reasoning Effort Support Opus 4.6+ supports `low`, `medium`, `high` effort levels via…
v1.9.0v1.9.0 - Per-Participant Reasoning Effort · 25 Nov 2025What's New Per-Participant Reasoning Effort Control Control reasoning depth for each participant independently, with config-based defaults: mcp__ai-counsel__deliberate({ question: "Complex architecture decision", participants: [ {cli:…
v1.8.0v1.8.0: Claude Opus 4.5 Support · 25 Nov 2025What's New Claude Opus 4.5 Support Added support for Anthropic's flagship model `claude-opus-4-5-20251101` across both Claude and Droid adapters. Model Specs: 200K token context window 64K token max output $5/M input, $25/M output (70%…
README
AI Counsel
| Item | Reference |
|---|---|
| Interface | MCP server over stdio |
| Function | Multi-model deliberation, structured votes, convergence detection |
| Runtime | Python 3.11; provider CLI or HTTP service |
| Configuration | config.example.yaml → config.yaml, loaded beside server.py |
| License | MIT |
Installation
git clone https://github.com/blueman82/ai-counsel.git
cd ai-counsel
cp config.example.yaml config.yaml
python3.11 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
| Provider type | Prerequisites |
|---|---|
| CLI | Installed executable; provider authentication; model access |
| Local HTTP | Running service; loaded model |
| Hosted HTTP | Provider account, API key, model access |
| Code search | Optional rg; Python fallback |
| Adapter | Transport | Shipped executable or endpoint |
|---|---|---|
claude, codex, droid, gemini |
CLI | Corresponding executable name |
llamacpp |
CLI | llama-cli |
ollama |
HTTP | http://localhost:11434 |
lmstudio |
HTTP | http://localhost:1234 |
openrouter |
HTTP | https://openrouter.ai/api/v1 |
nebius |
HTTP | https://api.tokenfactory.nebius.com/v1 |
openai |
HTTP | https://api.openai.com/v1 |
| Credentials | Configuration |
|---|---|
| Hosted HTTP | OPENROUTER_API_KEY, NEBIUS_API_KEY, OPENAI_API_KEY |
| Local file | Optional .env beside config.yaml; existing environment precedence |
| CLI authentication | Provider CLI configuration; separate from HTTP API keys |
MCP client configuration
- Placeholder replacement:
/absolute/path/to/ai-counsel→ clone directory. - Configuration key:
mcpServers; client-specific configuration file. - Transport: stdio; no HTTP listener.
{
"mcpServers": {
"ai-counsel": {
"command": "/absolute/path/to/ai-counsel/.venv/bin/python",
"args": ["/absolute/path/to/ai-counsel/server.py"]
}
}
}
- Manual stdio launch, from clone directory:
.venv/bin/python server.py
MCP tools
| Tool | Arguments | Result |
|---|---|---|
deliberate |
Required: question, participants, working_directory |
Responses, synthesis, votes, transcript path, cost summary |
list_models |
Optional: adapter |
Enabled registry models and defaults |
set_session_models |
Adapter keys mapped to model IDs or null |
Server-process overrides; null clears override |
query_decisions |
query_text, find_contradictions, decision_id, limit, threshold, format |
Decision search; registration conditional on graph enabled |
get_quality_metrics |
include_problem_models, min_responses, reset_after |
Response-format metrics; optional reset |
Deliberation arguments
| Field | Constraint / behavior |
|---|---|
question |
String; minimum 10 characters |
participants |
Minimum 2 entries; each with cli, optional model, optional reasoning_effort |
working_directory |
Required string; absolute existing project path recommended; file context and CLI cwd |
mode |
quick default: exactly one round; conference: requested round limit |
rounds |
Integer 1–5; default 2; conference early termination possible |
context |
Optional additional context string |
| Omitted model | Process override → registry default |
| Explicit model | Enabled registry ID where an allowlist is configured |
| Effort | Provider/model-specific; CLI model reference |
- Tool:
deliberate. - Placeholder replacement:
/absolute/path/to/project→ target project directory. - Prerequisites: authenticated Claude Code and Codex; access to selected models.
{
"question": "Which changes would improve test coverage in this repository?",
"participants": [
{"cli": "claude", "model": "claude-sonnet-5-5", "reasoning_effort": "high"},
{"cli": "codex", "model": "gpt-6.1-sol", "reasoning_effort": "high"}
],
"working_directory": "/absolute/path/to/project",
"mode": "conference",
"rounds": 2
}
Model selection
| Adapter | Enabled current-family IDs in shipped registry |
|---|---|
claude |
claude-opus-5-5 (default), claude-fable-5-1, claude-sonnet-5-5, claude-haiku-5-5 |
codex |
gpt-6.1-sol (default), gpt-6-astra, gpt-6-sol, gpt-6-luna |
openrouter, free entries |
google/gemma-4-26b-a4b-it:free, google/gemma-4-31b-it:free, nvidia/nemotron-3.5-lightning:free |
| Other adapters | list_models; full registry |
| Availability | Account and upstream dependent; registry membership ≠ successful invocation |
| Prices / billing | Dated sources and effort matrix; separate API, subscription, and Codex-credit units |
- Tool:
list_models.
{"adapter": "claude"}
- Tool:
set_session_models.
{"claude": "claude-sonnet-5-5", "codex": "gpt-6.1-sol"}
- Tool:
set_session_models; override removal.
{"claude": null, "codex": null}
Decision graph queries
- Tool:
query_decisions. - Prerequisite: enabled decision graph with stored deliberations.
{"query_text": "test coverage strategy", "limit": 5, "threshold": 0.6, "format": "summary"}
Configuration and output
| Setting / artifact | Behavior |
|---|---|
adapters |
Typed configuration; precedence over duplicate legacy cli_tools entries |
cli_tools |
Supported legacy CLI configuration; deprecation warning |
model_registry |
IDs, labels, defaults, enabled flags; disabled entries hidden from discovery |
deliberation.file_tree |
Initial tree injection; shipped depth 2, maximum 50 files |
deliberation.vote_retry |
Missing-vote retry; shipped maximum 1, minimum response length 100 |
deliberation.early_stopping |
Participant stop votes; shipped threshold 0.66 |
deliberation.convergence_detection |
Semantic convergence checks; configurable thresholds |
| Vote option grouping | Similarity threshold 0.85; separate convergence thresholds |
decision_graph.enabled |
Shipped true; stored decisions and retrieved context |
free_model_fallback.enabled |
Default false; opt-in fallback among enabled free models |
adapters.openrouter.rate_limiting |
Free-model spacing; bounded Retry-After handling |
cost_comparison |
Illustrative rate comparison; coverage and exclusions |
mcp.max_rounds_in_response |
Shipped 3; implementation caps entries in full_debate |
| Transcripts | transcripts/ beneath server launch directory; result transcript_path |
| Decision database | Relative path: deliberation storage from launch directory; query lookup beside server.py; absolute decision_graph.db_path for consistent resolution |
| Logs | mcp_server.log beside server.py; stderr logging |
File access and execution
| Surface | Actual boundary |
|---|---|
working_directory |
Context/cwd selection; no filesystem sandbox |
read_file |
UTF-8; configured exclusions; shipped 1 MiB limit; paths outside cwd possible |
search_code |
Pattern search; configured exclusions; rg or Python fallback |
list_files |
Glob discovery; configured exclusions |
get_file_tree |
Tree generation; configured depth/file limits |
run_command |
Executable allowlist; unrestricted arguments; 10-second timeout; no shell interpolation |
| Allowed commands | ls, pwd, cat, head, tail, wc, find, git, grep, awk, sed, sort, uniq, tree, file, stat, diff |
| Command side effects | Writes/network operations possible through allowed programs and arguments |
| Cwd handling | Process-wide directory changes during internal tool execution |
| Native CLI permissions | Provider-specific; shipped Codex workspace-write; Droid permission escalation |
| Provider data | Questions, context, retrieved decisions, responses, requested file content |
| Summary generation | Additional calls through enabled-model fallback chain; possible hosted-provider use with local participants |
| Credentials | Environment/.env; no secret-file exclusion guarantee |
| Persistence | Questions and arguments in logs; deliberation content in transcripts/database |
| Internal tool interface | Model-generated TOOL_REQUEST markers; not separate public MCP tools |
Free-model probe
| Evidence, 2026-10-10 | Measured outcome |
|---|---|
| Nemotron report | 3/3 valid vote-format rounds; small sample |
| Gemma report | Both variants: 3/3 HTTP 429; no successful vote-quality measurement |
| Interpretation | Format acceptance only; no uptime, answer-quality, or future availability guarantee |
| Authentication | OPENROUTER_API_KEY; missing key → skipped report |
| Price guard | Live catalogue check; nonzero-priced models rejected |
| Automation | Weekly/manual workflow; repository secret required |
.venv/bin/python -m scripts.probe_free_model_votes --help
- Optional live requests; provider quota consumption:
.venv/bin/python -m scripts.probe_free_model_votes \
--model nvidia/nemotron-3.5-lightning:free \
--rounds 3 --timeout 90 --output /tmp/free-model-votes.json
Development
.venv/bin/python -m pip install -r requirements-dev.txt
.venv/bin/python -m pytest tests/unit
| Area | Reference |
|---|---|
| MCP handlers and schemas | server.py |
| Request/result models | models/schema.py |
| Configuration validation | models/config.py |
| Execution and tools | Engine, tools |
| Adapter extension | CLI, HTTP |
| Tool extension | Adding a tool |
| Voting and convergence | Voting, convergence |
| Model selection | Registry and picker |
| HTTP setup | Ollama, LM Studio, OpenRouter |
| Decision memory | Configuration, troubleshooting |
| HTTP failures | Troubleshooting |
README fetched from the repository 7 hours ago. The original is authoritative.