MCP.Market

Anumana MCP server

by sinhaKAN-ra·io.github.sinhaKAN-ra/anumana·v0.2.1
No reviews yet

Predict query cost, explain the plan, and rewrite it before you run it — 12 DB engines.

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

0 stars49 downloads/wk

Reviews

Write one

Nobody has reviewed Anumana yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Anumana tools (9)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • describe_schema_tool
  • explain_query_working
  • list_policies

    List the operator's standing enforcement policies — the rules that can BLOCK or WARN on a query regardless of what you intend. Each has a name, scope (which target/engine), condition (risk tier and/or flag), and action (block/warn/allow). preflight_query and suggest_query already apply these and attach the verdict; call this to explain to a user WHY a query was blocked. No policies configured mean

  • list_targets

    List the databases Anumana is configured to analyse — each with its name, engine, and whether it's diagnosable. Call this FIRST in a multi-DB setup to see which target holds the data the user asked for, then pass target=<name> to the other tools. In a single-DB setup you can omit target and the one database is used. Never returns connection strings or secrets.

  • preflight_query
  • preflight_schema_only

    Analyse a query against pasted CREATE TABLE DDL with NO database connection — the zero-trust, offline front door. Call when the user gave you their schema (DDL) but not DB credentials. Catches SELECT *, missing LIMIT, un-indexed filter columns, LIKE '%...', functions on filtered columns. HEURISTIC only (no live counts) and says so. No target needed.

  • preflight_vector_search
  • rewrite_query
  • suggest_query

Public scan report

scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it

no findings
  • Code scan25 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 7 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Anumana compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 65% of 48,255 servers
Tools
9
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
49
more than 41% of 12,191 servers with a package

What its tools let an agent do: 9 read

Install Anumana in Claude Code, Cursor or VS Code

claude mcp add anumana -- uvx anumana-mcp
Add to Cursor

What the publisher says

From the Anumana repository's README, as published. We do not edit it. Read it on GitHub

Anumana

<!-- mcp-name: io.github.sinhaKAN-ra/anumana -->

Know what your query will cost — before you run it. Inference-grade foresight for every query your AI writes.

Anumana is an MCP server that catches the costly query your AI coding agent just wrote — before it runs or reaches a PR. It rides inside Claude, Cursor, Windsurf, Codex, Kiro, or any MCP-compatible agent, reads your real schema via EXPLAIN (never EXPLAIN ANALYZE), and tells you — in plain English — how the query behaves and whether it'll hurt.

Its scope is the queries AI agents actually generate: text-to-SQL today, and RAG / vector search (pgvector) alongside it — because an agent writing a similarity search has no idea it just triggered a brute-force scan over every embedding. Anumana is the feedback loop the agent is missing.

It is not another NL→SQL tool and not a DB-health dashboard. It does one job: stop AI-written database code from silently rotting production.

What it does (the features)

Engines (12, across 7 paradigms): Postgres and SQLite are live-tested;

MySQL, pgvector, MongoDB, DynamoDB, FalkorDB, Cassandra, Redshift, BigQuery,

Snowflake and ClickHouse ship as offline-verified, untested adapters that

are promoted to live one at a time. Full matrix + cost signals in

SUPPORTED_ENGINES.md. The adapter interface is in

DESIGN.md.

The one honest rule

Postgres planner cost is unitless — not milliseconds (docs). Anumana never fakes a ~3.2s number. It reports rows scanned, scan strategy, a risk tier, overhead flags, and the cost-delta of a rewrite — all defensible, nothing invented. Every estimate carries an accuracy tier (UPPER_BOUND live, HEURISTIC schema-only).

Install

pip install anumana-mcp          # once published to PyPI
# or from source:
pip install -e .

Then point your agent at it. The user installs it; the agent discovers the tools automatically on connect via the MCP tools/list handshake — there is no store to publish into.

Claude Desktop / Cursor / Windsurf / Kiro — mcpServers config block

{
  "mcpServers": {
    "anumana": {
      "command": "uvx",
      "args": ["anumana-mcp"],
      "env": { "ANUMANA_DSN": "postgres://readonly@localhost:5432/mydb" }
    }
  }
}

Use a read-only Postgres role. Anumana only ever EXPLAINs, but read-only is defence in depth. Omit ANUMANA_DSN to run in schema-only mode (DDL in, no DB).

Try it with no database (30 seconds)

python3 src/demo.py          # runs the engine on a canned plan, zero deps

Test against a real Postgres

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Anumana: common questions

Is Anumana MCP server safe?
Mostly: it is graded B (83/100). Read the Anumana safety report
How do I install Anumana?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Anumana need an API key?
Yes. The registry entry asks for ANUMANA_DSN, ANUMANA_TARGETS.
Is Anumana maintained?
The last commit was 28 days ago (2026-10-07). The latest release is v0.2.1.
How does Anumana compare with other MCP servers?
safety score 83/100 (higher than 65% of 48,255 servers); tools 9 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.