Skip to main content

decimalai-mcp

Part of DecimalAI. Most users want the Python SDK → decimal-labs/decimalai-python.

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.

PyPI Downloads CI Python License

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, and how to install it (decimalai skills add <slug>, the folder it lands in, and the Claude Code --plugin-dir line)
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

Run pytest yourself before opening a PR. CI also asserts that the pinned mcp<2 still provides FastMCP, which the mocked tests do not cover — run that one too:

python -c "from mcp.server.fastmcp import FastMCP; import decimalai_mcp.server"

Releases are cut from a published GitHub Release — see RELEASING.md for the gates a change has to pass and the version strings that must move together.

License

MIT

Metadata

Release files for decimalai-mcp 0.1.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for decimalai-mcp 0.1.5
File Size Uploaded Provenance Actions
decimalai_mcp-0.1.5.tar.gz 23.5 kB With provenance Details for decimalai_mcp-0.1.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for decimalai-mcp 0.1.5
File Interpreter ABI Platform Actions
decimalai_mcp-0.1.5-py3-none-any.whl Python 3 none any Details for decimalai_mcp-0.1.5-py3-none-any.whl

Total release size: 39.1 kB

Release files / decimalai_mcp-0.1.5.tar.gz

Download URL decimalai_mcp-0.1.5.tar.gz
Size 23.5 kB
Tags Source
SHA-256 checksum
How to use checksums
db7d429f061bfed02f2d2b0c01d7fa6b66e3067e65ca8c10cb9040a7ba76b13b
BLAKE2b-256 checksum
How to use checksums
0ab61f5cb997ad583a70242a93ab8cc4792bc914ef916caf26ca0f370d9aaa46
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Release files / decimalai_mcp-0.1.5-py3-none-any.whl

Download URL decimalai_mcp-0.1.5-py3-none-any.whl
Size 15.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cd02b8fdd17608d0da026cdeac7e2f1fa0a29f05ed444dcc113cb9aba2674252
BLAKE2b-256 checksum
How to use checksums
bb9db09070e77709fa1710555c446c8b8b0d90d44e88b5efcf914f09be025a6d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Security for decimalai-mcp 0.1.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for decimalai_mcp-0.1.5.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page