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.1.tar.gz (16.7 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.1-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: decimalai_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 16.7 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.1.tar.gz
Algorithm Hash digest
SHA256 46b9810c155222d6cc1def21dd3f460e6ad817e501b56f8ff99fb0f80e0aed8a
MD5 f054ad30d28f2555ec5e76ce4a9b3781
BLAKE2b-256 f446c5733e1c4cbcd0297ba95aeff365596d4355ae14c34e6cfa65696d498dfd

See more details on using hashes here.

File details

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

File metadata

  • Download URL: decimalai_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 9.6 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 32b473a399e6b5172766cc322f62fdbadbd0a58c970c235af878f28df9a0ad1c
MD5 ce889daf4beda4383914bff6fa275a8b
BLAKE2b-256 c4f27c18e9571c1493162dd5f4c673f32e88660354c96cb6fa7f8341899befdf

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