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.28

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.28
File Size Uploaded Provenance
deepset_mcp-0.1.28.tar.gz 25.5 MB With provenance Details

Built distribution (wheel)

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

Total release size: 25.7 MB

Release files / deepset_mcp-0.1.28.tar.gz

Download URL deepset_mcp-0.1.28.tar.gz
Size 25.5 MB
Tags Source
SHA-256 checksum
How to use checksums
4e4181870a11502e5d85fb01481e8d13852fdb520eb552497d27bd17844b8d36
BLAKE2b-256 checksum
How to use checksums
825ae83af3baf4af842a376bb5706563e4275baff9b3a4bc22dddd419199bfbb
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 6, 2026.

Transparency log

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

Download URL deepset_mcp-0.1.28-py3-none-any.whl
Size 162.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b767e0c76c300c28a71babc69f9f6801d6feca26343e15518f9ee919f50d0727
BLAKE2b-256 checksum
How to use checksums
9450f035d9388374a809f5ff3dad7d990f4ded0949095afd31ef04de2a24857a
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 6, 2026.

Transparency log

Security for deepset-mcp 0.1.28

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.28.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 6, 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.28 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