Skip to main content

decimalai-mcp

MCP server for the DecimalAI skills registry — the registry that ranks agent skills by measured effectiveness (verified A/B benchmarks, live pass rates, AI rater scores), not download counts.

Gives any MCP client (Claude Desktop, Claude Code, Cursor, …) three read-only tools:

Tool What it does
search_skills(query, category?, sort?, limit?) Hybrid keyword/semantic search over the public registry
get_skill(slug) Full record: trust & safety-scan status, verified benchmark lift, SkillScore, ratings, SKILL.md body
get_leaderboard(sort?, category?, window_days?, limit?) Ranked leaderboard: skill_score, biggest_improvement, efficiency, top_rated

No API key required — all three tools read public registry endpoints. If you set DECIMAL_API_KEY (from app.decimal.ai/settings), the same tools additionally show which skills your org has already installed (installed_as).

Install

pip install decimalai-mcp
# or, no install needed at config time:
uvx decimalai-mcp

Requires Python 3.10+.

Claude Code

claude mcp add decimalai -- uvx decimalai-mcp
# with an API key:
claude mcp add decimalai -e DECIMAL_API_KEY=dai_sk_... -- uvx decimalai-mcp

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "decimalai": {
      "command": "uvx",
      "args": ["decimalai-mcp"],
      "env": {
        "DECIMAL_API_KEY": "dai_sk_optional"
      }
    }
  }
}

Omit the env block entirely for anonymous read-only access.

Configuration

Env var Default Purpose
DECIMAL_API_KEY (unset) Optional. Unlocks per-org enrichment (e.g. installed_as) on the same public endpoints.
DECIMAL_API_URL https://api.decimal.ai Point at a self-hosted / local backend.

Why no check_manifest_impact tool?

The manifest-impact endpoint (POST /api/v1/regression-check) is authenticated on the platform — it analyzes your org's production traces against a candidate manifest, so there is no public variant to expose. This server is deliberately a read-only, key-optional public-registry surface. If demand shows up, an authed check_manifest_impact (requiring DECIMAL_API_KEY) is a natural v0.2 addition; the regression-check GitHub Action covers the CI use-case today.

Endpoints used (all public)

  • GET /api/v1/registry/skills — browse/search
  • GET /api/v1/registry/skills/{slug} — detail
  • GET /api/v1/registry/leaderboard — ranked leaderboard (category filtering falls back to the browse endpoint's documented view=ranks mode, because the leaderboard endpoint is uncategorized)

Development

pip install -e ".[dev]"
pytest              # all HTTP mocked; no network
python -m decimalai_mcp.server   # run over stdio

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

decimalai_mcp-0.1.0.tar.gz (16.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

decimalai_mcp-0.1.0-py3-none-any.whl (9.3 kB view details)

Uploaded Python 3

File details

Details for the file decimalai_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: decimalai_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 16.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for decimalai_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a9230059981772340574b486b9f45b77e39a92488e611006b9883afb1586ba22
MD5 a1893481b390abb39eea12ca6817890a
BLAKE2b-256 ca53eb9ded81adf95bfc5b87e59dc031d6cc7cedd0d11e121844b1179094c9c8

See more details on using hashes here.

File details

Details for the file decimalai_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: decimalai_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 9.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for decimalai_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a0725541ff9ddc2d670ffac2e1e88209ffbe19083699d438c02ad043e798a076
MD5 49cf8d9211a7e9e4d7195d2e0794b514
BLAKE2b-256 747f3c1237fbdb490023f32437ddde9eabb9253944b8b399b9e8072ffe0a9b40

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page