Skip to content
MCP server

onomeo

Ask free LLMs for a second opinion or compare answers from inside any MCP client

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About onomeo

onomeo is a freemium MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

Onomeo-mcp lets a coding agent hand a prompt to other models through onomeo, an OpenAI-compatible API. A rotating set of models, including DeepSeek, GLM, Gemini and Mistral, is free to call without a card, and the rest are pay-as-you-go. An API key from onomeo.com is required.

The three tools are simple. list_models shows what is being served now, ask_model defaults to auto and reports which free model answered, and compare_models sends one prompt to two to four models in parallel. The README gives free limits of 30 calls per 5 hours per account, with each call covering up to 50,000 characters, checked on 2026-10-10.

It warns that free models run through third-party free tiers that may train on prompts, so do not send secrets or private code. The project is in public beta, MIT licensed, and written by the operator of onomeo.

Install

Run in a terminal

claude mcp add onomeo-mcp --env ONOMEO_API_KEY='<ONOMEO_API_KEY>' -- npx -y https://github.com/Owaid0723666/onomeo-mcp/releases/download/v0.1.0/onomeo-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "onomeo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Owaid0723666/onomeo-mcp/releases/download/v0.1.0/onomeo-mcp.mcpb"
      ],
      "env": {
        "ONOMEO_API_KEY": "<ONOMEO_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "onomeo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Owaid0723666/onomeo-mcp/releases/download/v0.1.0/onomeo-mcp.mcpb"
      ],
      "env": {
        "ONOMEO_API_KEY": "<ONOMEO_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "onomeo-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Owaid0723666/onomeo-mcp/releases/download/v0.1.0/onomeo-mcp.mcpb"
      ],
      "env": {
        "ONOMEO_API_KEY": "<ONOMEO_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "onomeo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Owaid0723666/onomeo-mcp/releases/download/v0.1.0/onomeo-mcp.mcpb"
      ],
      "env": {
        "ONOMEO_API_KEY": "<ONOMEO_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "onomeo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Owaid0723666/onomeo-mcp/releases/download/v0.1.0/onomeo-mcp.mcpb"
      ],
      "env": {
        "ONOMEO_API_KEY": "<ONOMEO_API_KEY>"
      }
    }
  }
}

Configuration

  • ONOMEO_API_KEYAPI key from https://onomeo.com (free to create)Required

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

list_models
Lists models served now, split into free and pay-as-you-go.
ask_model
Sends a prompt to one model and returns the answer.
compare_models
Sends a prompt to 2 to 4 models and returns answers side by side.

What it does

Second-opinion queries
Send a prompt to another model and get its answer.
Auto model choice
Picks a healthy free model and says which answered.
Side-by-side compare
Same prompt to 2 to 4 models in parallel.
Live model list
Shows free and pay-as-you-go models and the call limit.
MCPB bundle
Claude Desktop install from a release file.

Good for

  • Ask DeepSeek to review a diff
  • Send one regex question to three models
  • Check which free models are up
  • Cross-check a design answer with another model

Pricing

Freemium

Free models with limits; paid models pay-as-you-go from a 5 USD top-up

Prices change. Check onomeo.com before you buy.

onomeo FAQ

Do I need a key?

Yes, an ONOMEO_API_KEY from onomeo.com, but list_models works without one.

What are the free limits?

30 calls per 5 hours per account, refilled automatically.

Is it safe for private code?

The README advises against sending secrets or private code to free models.

What licence is it?

MIT.

Is onomeo free?

onomeo has a free plan, with paid plans for more usage or features.

How do I add onomeo to Claude Code?

Run this command in your terminal: claude mcp add onomeo-mcp --env ONOMEO_API_KEY='<ONOMEO_API_KEY>' -- npx -y https://github.com/Owaid0723666/onomeo-mcp/releases/download/v0.1.0/onomeo-mcp.mcpb

What are the best alternatives to onomeo?

The closest alternatives to onomeo are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to onomeo

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools