Skip to main content

deepset-mcp

The official MCP server and Python SDK for the Haystack Enterprise Platform

deepset-mcp enables AI agents to build and debug pipelines on the Haystack Enterprise Platform through 45+ specialized tools. It also provides a Python SDK for programmatic access to many platform resources.

Documentation

📖 View the full documentation

Development

Installation

Install the project using uv:

# Install uv first
pipx install uv

# Install project with all dependencies
uv sync --locked --all-extras --all-groups

Local Development

If you want to test your changes locally, follow these steps:

  1. Add a script run-deepset-mcp.sh that uses the binary from the project's virtual env
#!/usr/bin/env bash
# Wrapper to run the local deepset-mcp server for Cursor MCP.
# Use this as command so it doesn't depend on uv or PATH.
set -e
cd "$(dirname "$0")"
exec .venv/bin/deepset-mcp
  1. Use it this way in Cursor:
    "deepset": {
      "command": "/bin/bash",
      "args": ["/Users/*****/****/deepset-mcp-server/run-deepset-mcp.sh"],
      "cwd": "/Users/*****/****/deepset-mcp-server",
      "env": {
        "DEEPSET_WORKSPACE": "WORKSPACE",
        "DEEPSET_API_KEY": "API_KEY"
      }
    }

Note: If you change the codebase, make sure to restart the MCP server.

Code Quality & Testing

Run code quality checks and tests using the Makefile:

# Install dependencies
make install

# Code quality
make lint          # Run ruff linting
make format        # Format code with ruff
make types         # Run mypy type checking

# Testing
make test          # Run unit tests (default)
make test-unit     # Run unit tests only
make test-integration     # Run integration tests
make test-all      # Run all tests

# Clean up
make clean         # Remove cache files

Documentation

Documentation is built using MkDocs with the Material theme:

  • Configuration: mkdocs.yml
  • Content: docs/ directory
  • Auto-generated API docs via mkdocstrings
  • Deployed via GitHub Pages (automated via GitHub Actions on push to main branch)

Metadata

Release files for deepset-mcp 0.1.33

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

Source distribution (sdist)

Source distribution for deepset-mcp 0.1.33
File Size Uploaded Provenance
deepset_mcp-0.1.33.tar.gz 25.5 MB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for deepset-mcp 0.1.33
File Interpreter ABI Platform
deepset_mcp-0.1.33-py3-none-any.whl Python 3 none any Details

Total release size: 25.7 MB

Release files / deepset_mcp-0.1.33.tar.gz

Download URL deepset_mcp-0.1.33.tar.gz
Size 25.5 MB
Tags Source
SHA-256 checksum
How to use checksums
43a8c6c5426b091b4be9aa2c5974e627af2e3b735426658cab1c1d66a717d3a3
BLAKE2b-256 checksum
How to use checksums
4561f65103cf9cdde3a6ddfc1031e50484778511b72a9d762615fef15866cf58
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 Oct 15, 2026.

Transparency log

Release files / deepset_mcp-0.1.33-py3-none-any.whl

Download URL deepset_mcp-0.1.33-py3-none-any.whl
Size 178.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2dbbee483ec5a85f791e3a8f7dae7f41e276306a1764633508682e9c1eea6ee4
BLAKE2b-256 checksum
How to use checksums
187a6771e21e0d8710b22d9a4972fa987c6342bf3e3887988291dd9e140db628
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 Oct 15, 2026.

Transparency log

Security for deepset-mcp 0.1.33

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

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for deepset_mcp-0.1.33.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 Oct 15, 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.

Release history Release notifications | RSS feed

This release

0.1.33 This release

2 release files Full provenance

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