Skip to main content

DBOS MCP Server

This repository contains a Model Context Protocol (MCP) server with tools that can analyze and manage your DBOS workflows. It enables LLMs to retrieve information on your applications' workflows and steps, for example to help you debug issues in development or production. To use this server, your application should be connected to Conductor.

You may want to use this alongside a DBOS prompt (Python, TypeScript, Go, Java) so your model has the most up-to-date information on DBOS.

Setup

Install uv

Before using this MCP server, you must install uv. For installation instructions, see the uv installation docs.

Setup with Claude Code

To use this MCP server with Claude Code, first install it:

claude mcp add dbos-conductor -- uvx dbos-mcp

Then start Claude Code and ask it questions about your DBOS apps! Claude will prompt you to log in by clicking the URL it offers and authenticating in the browser.

Credentials are stored in ~/.dbos-mcp/credentials.

Tools

Application Introspection

  • list_applications - List all applications
  • list_executors - List connected executors for an application

Workflow Introspection

  • list_workflows - List/filter workflows
  • get_workflow - Get workflow details
  • list_steps - Get execution steps for a workflow

Workflow Management

  • cancel_workflow - Cancel a running workflow
  • resume_workflow - Resume a pending or failed workflow
  • fork_workflow - Fork a workflow from a specific step

Authentication

  • login - Start login flow (returns URL to login page)
  • login_complete - Complete login after authenticating

Download files

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

Source Distribution

dbos_mcp-0.8.0.tar.gz (103.2 kB view details)

Uploaded Source

Built Distribution

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

dbos_mcp-0.8.0-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

Details for the file dbos_mcp-0.8.0.tar.gz.

File metadata

  • Download URL: dbos_mcp-0.8.0.tar.gz
  • Upload date:
  • Size: 103.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for dbos_mcp-0.8.0.tar.gz
Algorithm Hash digest
SHA256 39593bd62e505cf8607e7767c7323e1f3d30cca8ce07298033c631a83e2fe60a
MD5 ce2413fc0900504cc7b08c5f51a9ff88
BLAKE2b-256 a1f0e5b473b9a40bcb06e18a07fe8cd58b653209fa2391d986e9f8890734f0f3

See more details on using hashes here.

Provenance

The following attestation bundles were made for dbos_mcp-0.8.0.tar.gz:

Publisher: publish.yml on dbos-inc/dbos-mcp

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

File details

Details for the file dbos_mcp-0.8.0-py3-none-any.whl.

File metadata

  • Download URL: dbos_mcp-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 15.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for dbos_mcp-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 65587a2a3b7a36499f897a714e0b415c718c732cb7d50d7bd3be27b3041fc3b2
MD5 81b1001825f4f1011b993bed05c8bcc8
BLAKE2b-256 247da2f6bc5cfa341efcde83d94cc57637b53d91543a45a5d5861bf12c77875f

See more details on using hashes here.

Provenance

The following attestation bundles were made for dbos_mcp-0.8.0-py3-none-any.whl:

Publisher: publish.yml on dbos-inc/dbos-mcp

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

Release history Release notifications | RSS feed

This release

0.8.0 This release

2 files

0.7.0

2 files

0.6.0

2 files

0.5.0

2 files

0.3.0

2 files

0.2.1

2 files

0.2.0

2 files

0.1.0

2 files

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