DeepSieve MCP server

Two ways to connect. This package is the stdio + API-key server — ideal for CI, containers, and services. Where a deployment has the remote server with browser login enabled, that route is easier for a developer at their editor — no key to manage. It is not enabled on every deployment, so see https://deepsieve.ai/developers/mcp for the current endpoint rather than assuming one.

Gives any MCP client (Claude Code, Cursor, Claude Desktop, …) nine outcome-shaped tools over the DeepSieve /v1 API: verify the account, discover the Blueprint schema, start/poll/cancel research runs, read the cited dataset incrementally, export it, and inspect webhooks.

It is a plain API client — it holds no privileged access, only the scoped key you give it (mint one with the Agent preset at /settings/api-keys; it can run research and read results but can't touch your schema or billing).

Install

🛑 0.1.0 does not start, and 0.1.1 fixes it. 0.1.0 declared an unbounded mcp>=1.2.0; mcp 2.x renamed FastMCP to MCPServer, so on 0.1.0 uvx deepsieve-mcp fails with ModuleNotFoundError: No module named 'mcp.server.fastmcp'. Nothing in this package changed — the dependency released a major, months after we published.

0.1.1 caps the dependency at mcp<2 and starts normally, so plain uvx deepsieve-mcp is correct again. If you are pinned to 0.1.0, add one flag: uvx --with 'mcp<2' deepsieve-mcp (or "args": ["--with", "mcp<2", "deepsieve-mcp"] in the JSON below).

The port to mcp 2.x — which is what will let the cap come off — is tracked in #796.

# Claude Code
claude mcp add deepsieve \
  --env DEEPSIEVE_API_KEY=ds_live_... \
  --env DEEPSIEVE_API_URL=https://deepsieve.ai \
  -- uvx deepsieve-mcp

Manual mcpServers JSON (Cursor, Claude Desktop):

{
  "mcpServers": {
    "deepsieve": {
      "command": "uvx",
      "args": ["deepsieve-mcp"],
      "env": {
        "DEEPSIEVE_API_KEY": "ds_live_...",
        "DEEPSIEVE_API_URL": "https://deepsieve.ai"
      }
    }
  }
}

DEEPSIEVE_API_URL defaults to http://localhost:8200 (local dev stack).

Tools

get_account · get_blueprint · start_research · get_run_status · list_runs · cancel_run · query_entities · export_dataset · list_webhooks · list_members

Full API docs: /developers on your deployment (also /llms.txt). PyPI/npm publishing and a hosted Streamable-HTTP OAuth server are tracked follow-ups (issue #116 Phase-2).

Download files

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

Source Distribution

deepsieve_mcp-0.3.0.tar.gz (12.4 kB view details)

Uploaded Sep 9, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

deepsieve_mcp-0.3.0-py3-none-any.whl (11.0 kB view details)

Uploaded Sep 9, 2026 Python 3

File details

Details for the file deepsieve_mcp-0.3.0.tar.gz.

File metadata

Download URL: deepsieve_mcp-0.3.0.tar.gz
Upload date: Sep 9, 2026
Size: 12.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for deepsieve_mcp-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`b20466c269ebe23e82edd8648993f3b9357e30b361539026a93ce0096d9ca2f8`
MD5	`f027eb1aeb76fac69a6e64e600f82313`
BLAKE2b-256	`79b4f4e705cd7e0da8ca051c4cef90baa4acfba5e69f9deb0ae09d8de5d2aef1`

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepsieve_mcp-0.3.0.tar.gz:

Publisher: publish-mcp.yml on honeynudger/deep-sieve

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: deepsieve_mcp-0.3.0.tar.gz
- Subject digest: b20466c269ebe23e82edd8648993f3b9357e30b361539026a93ce0096d9ca2f8
- Sigstore transparency entry: 2767024852
- Sigstore integration time: Sep 9, 2026
Source repository:
- Permalink: honeynudger/deep-sieve@45082575c26f1a421776768daff250f7dd239339
- Branch / Tag: refs/tags/mcp-v0.3.0
- Owner: https://github.com/honeynudger
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-mcp.yml@45082575c26f1a421776768daff250f7dd239339
- Trigger Event: push