Skip to main content

MCP proxy command for deepctl — connects to Deepgram's developer API

Project description

deepctl-cmd-mcp

Part of deepctl — Official Deepgram CLI

MCP proxy command for deepctl — connects to Deepgram's developer API

Installation

This package is included with deepctl and does not need to be installed separately.

Install deepctl

# Install with pip
pip install deepctl

# Or install with uv
uv tool install deepctl

# Or install with pipx
pipx install deepctl

# Or run without installing
uvx deepctl --help
pipx run deepctl --help

Commands

Command Entry Point
deepctl mcp deepctl_cmd_mcp.command:McpCommand

MCP Server Setup

The deepctl mcp command runs an MCP (Model Context Protocol) proxy that connects to Deepgram's developer API and exposes tools to AI code editors.

Prerequisites

# Login to Deepgram (stores credentials in system keyring)
deepctl login

# Or set the environment variable
export DEEPGRAM_API_KEY="your-api-key"

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "deepgram": {
      "type": "stdio",
      "command": "uvx",
      "args": ["deepctl", "mcp"]
    }
  }
}

Or with an explicit API key:

{
  "mcpServers": {
    "deepgram": {
      "type": "stdio",
      "command": "uvx",
      "args": ["deepctl", "--api-key", "YOUR_KEY", "mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "deepgram": {
      "command": "uvx",
      "args": ["deepctl", "mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "deepgram": {
      "command": "uvx",
      "args": ["deepctl", "mcp"]
    }
  }
}

Alternative: pipx

Replace uvx with pipx run in any of the above configurations:

{
  "command": "pipx",
  "args": ["run", "deepctl", "mcp"]
}

Alternative: Local development

If running from a local clone of the repository:

{
  "command": "uv",
  "args": ["run", "dg", "mcp"]
}

Transport modes

By default the MCP server uses stdio (for editor integration). You can also run it as an HTTP server:

# SSE transport
deepctl mcp --transport sse --port 8000

Dependencies

  • mcp>=1.0.0
  • rich>=13.9.4
  • click>=8.1.7
  • pydantic>=2.10.1
  • uvicorn>=0.30.0
  • starlette>=0.37.0

License

MIT — see LICENSE

Project details


Download files

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

Source Distribution

deepctl_cmd_mcp-0.1.11.tar.gz (7.1 kB view details)

Uploaded Source

Built Distribution

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

deepctl_cmd_mcp-0.1.11-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

Details for the file deepctl_cmd_mcp-0.1.11.tar.gz.

File metadata

  • Download URL: deepctl_cmd_mcp-0.1.11.tar.gz
  • Upload date:
  • Size: 7.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for deepctl_cmd_mcp-0.1.11.tar.gz
Algorithm Hash digest
SHA256 5aaa5d2d4b2afe62eb2d957b0e54c9c993f568db948126f4262098847f578a6e
MD5 27207038519aaee41c09ecbf73329efd
BLAKE2b-256 b20ebeacbf20035b009a0558bd6cc446ce2fd01cf98ec0d900124d01a8cee15f

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepctl_cmd_mcp-0.1.11.tar.gz:

Publisher: release.yml on deepgram/cli

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

File details

Details for the file deepctl_cmd_mcp-0.1.11-py3-none-any.whl.

File metadata

File hashes

Hashes for deepctl_cmd_mcp-0.1.11-py3-none-any.whl
Algorithm Hash digest
SHA256 c1c0340b0b39ad4f23a9bc3fe16f2d0cbcdddc3a212f4dcd14d76c626f7b5208
MD5 72109837f85037210ed56602bd6286ea
BLAKE2b-256 b3451f2a966266995aed0d14b2667ce990de68853a2e616366a8697040180912

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepctl_cmd_mcp-0.1.11-py3-none-any.whl:

Publisher: release.yml on deepgram/cli

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page