Skip to main content
Glama
JoaoPauloNA

Athena-MCP

by JoaoPauloNA
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Athena-MCP πŸ”±

CI License: MIT Python 3.10+ Ruff PRs Welcome

OmniRouter for AI-agent CLIs β€” one MCP server to detect, route, verify and economize across every AI CLI on your machine.

πŸ‡§πŸ‡· Leia em PortuguΓͺs Β· πŸ‡¨πŸ‡³ ι˜…θ―»δΈ­ζ–‡

What is Athena-MCP?

Athena-MCP turns the AI CLIs installed on your machine (Codex, Claude Code, Cursor Agent, Antigravity, OpenCode, Ollama and more) into a single orchestrated council, exposed both as an MCP server (so any AI chat can delegate tasks) and a web dashboard for management.

Instead of betting on one agent, Athena:

  • Detects every AI CLI on your system automatically (macOS, Windows, Linux)

  • Routes each task to the best provider/model using an auto-updating ratings table

  • Verifies execution reports against real project evidence β€” a "lie detector" that catches agents claiming work they never did

  • Economizes by steering simple tasks away from expensive heavy models

  • Fails over across providers with configurable combos

Related MCP server: consult-mcp

Features

Feature

Description

πŸ” Cross-platform CLI scanner

Finds AI CLIs on PATH + ~/.local/bin, Homebrew, npm global, Scoop, cargo, go, flatpak, snap… 23 known CLIs listed even when not installed

πŸ“Š Dashboard

Providers, models, combos, usage stats and the "Best per Role" table at localhost:7100

πŸ† Model ratings table

Scores 0–10 per role (frontend, backend, reasoning, speed), refreshed weekly from live leaderboards (SWE-bench, GPQA, Design Arena)

πŸ•΅οΈ Lie detector (verifier)

A cheap/free model (OpenCode free tier first) cross-checks each report against git evidence; false reports go back for fixing once, then escalate to the orchestrator

πŸ’‘ recommend tool

Describe a task, get the best installed provider+model with reasoning

πŸ’° Economy routing

Task complexity estimation; heavy models are excluded from suggestions for simple tasks

πŸ”„ Combos with failover

Chains of providers with retries, per-step models and timeout policies

πŸ“œ 10-topic report contract

Executors return lean structured reports β€” the orchestrator's context stays clean

Quick start

git clone https://github.com/JoaoPauloNA/athena.git
cd athena
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

Run the dashboard:

python -c "from athena.dashboard.app import run_dashboard; run_dashboard()"   # API on :20129
cd frontend && npx vite --port 7100                                            # UI on :7100

Run as an MCP server (stdio), e.g. in your MCP client config:

{
  "mcpServers": {
    "athena": {
      "command": "/path/to/.venv/bin/python",
      "args": ["-m", "athena.mcp_server"],
      "cwd": "/path/to/athena-mcp"
    }
  }
}

MCP tools

Tool

Purpose

list_providers

Installed/available CLIs, models, roles, ratings

ask_provider

Send a task to one provider (verify=true enables the lie detector)

run_combo

Run a prompt through a failover chain

deliberate

Ask several agents in parallel

recommend

"Who should I call for this task?" β€” ratings Γ— installed models Γ— complexity

refresh_models

Re-scan CLI model catalogs

list_usage

Per-provider call counters and token estimates

How verification works

Orchestrator β†’ Executor CLI β†’ 10-topic report
                     β”‚
                     β–Ό
        Verifier (cheapest available model,
        never the executor's own provider)
        checks git status/diff + cited files
                     β”‚
        TRUE ────────┴──────── FALSE
         β”‚                       β”‚
      accepted            sent back to executor (1x)
                               β”‚
                     TRUE ─────┴──── FALSE again
                      β”‚                 β”‚
                   accepted      ESCALATE to orchestrator
                                 (verdict + evidence + history)

Documentation

Requirements

  • Python β‰₯ 3.10

  • At least one AI CLI installed (Codex, Claude Code, Cursor Agent, Antigravity, OpenCode, Ollama…)

  • Node.js (only for the dashboard dev server)

License

MIT Β© 2026 JoΓ£o Paulo

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • microservices.sh

    MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

  • PlanWright

    Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.

  • mcp

    MCP server connecting AI agents to non-custodial staking data across 130+ networks.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JoaoPauloNA/athena'

If you have feedback or need assistance with the MCP directory API, please join our Discord server