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.7.0.tar.gz (101.9 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.7.0-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: dbos_mcp-0.7.0.tar.gz
  • Upload date:
  • Size: 101.9 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.7.0.tar.gz
Algorithm Hash digest
SHA256 aea6b2d59af993a177182fce5fba33e321245074a77af98da631c5a3c22beb70
MD5 6ac499793d878971547c89ce8b8cfbfd
BLAKE2b-256 0471408f8f40bc1abde371ab45aeb30d79eada54b4364c207aad226afed71b3f

See more details on using hashes here.

Provenance

The following attestation bundles were made for dbos_mcp-0.7.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.7.0-py3-none-any.whl.

File metadata

  • Download URL: dbos_mcp-0.7.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.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 63e32b8db2fddb99724df52b26f54bbd716ae6204e122c8a3782207f8bc87f36
MD5 a6152ca3db71483d29cc7cc676e16b19
BLAKE2b-256 50d65cc44c76f2b315f0603ef09d4997c926c0a8cf2aed2b1f22523b3e17dc6c

See more details on using hashes here.

Provenance

The following attestation bundles were made for dbos_mcp-0.7.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

0.8.0

2 files

This release

0.7.0 This release

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