Skip to main content

Standalone MCP proxy for Deepgram's developer API — remote-proxy architecture with zero client upgrades

Project description

deepgram-mcp

Deepgram's Model Context Protocol server — gives AI editors (Claude Code, Cursor, Windsurf, and others) direct access to Deepgram's speech, transcription, and audio intelligence tools.

Standalone package. Install deepgram-mcp directly if you want just the MCP server without the full CLI suite. If you already use the Deepgram CLI (pip install deepctl), deepgram-mcp is included as a dependency and the dg mcp command wraps it — no separate install needed.

Why deepgram-mcp is different

Most MCP servers ship tools as hardcoded Python. When the provider adds a new tool, you must upgrade the package to get it.

deepgram-mcp fetches its tool list from Deepgram's API at runtime. New tools appear in your editor the next time you connect — no package upgrade required.

Requirements

A Deepgram API key. Get one free at console.deepgram.com.

Set it as an environment variable:

export DEEPGRAM_API_KEY=your_api_key_here

Installation

pip install deepgram-mcp

Editor setup

Claude Code

Add to .mcp.json in your project root (or ~/.claude/mcp.json for global):

{
  "mcpServers": {
    "deepgram": {
      "command": "deepgram-mcp",
      "env": {
        "DEEPGRAM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or via CLI:

claude mcp add deepgram -- deepgram-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "deepgram": {
      "command": "deepgram-mcp",
      "env": {
        "DEEPGRAM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "deepgram": {
      "command": "deepgram-mcp",
      "env": {
        "DEEPGRAM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Usage

stdio (default — for editor integration)

deepgram-mcp --api-key your_api_key_here

SSE (HTTP server)

deepgram-mcp --transport sse --port 8000

Options

Flag Default Description
--transport stdio Transport mode: stdio or sse
--port 8000 Port for SSE server
--host 127.0.0.1 Host for SSE server
--api-key $DEEPGRAM_API_KEY Deepgram API key
--base-url https://api.dx.deepgram.com Deepgram developer API base URL
--debug false Print debug info to stderr

Use as a library

import asyncio
from deepgram_mcp import run_proxy

asyncio.run(run_proxy(
    transport="stdio",
    host="127.0.0.1",
    port=8000,
    api_key="your_api_key_here",
    base_url="https://api.dx.deepgram.com",
    debug=False,
))

Deepgram CLI

If you use the Deepgram CLI, dg mcp wraps this package and handles authentication automatically:

dg mcp
dg mcp --transport sse --port 8000

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

deepgram_mcp-0.1.1.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

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

deepgram_mcp-0.1.1-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file deepgram_mcp-0.1.1.tar.gz.

File metadata

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

File hashes

Hashes for deepgram_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 907955b48130f57d91a81342f1adeeb7a37153d042e1e7affc8fc85f90e3bf54
MD5 0494a79de18d3e08db17eb399f53eb82
BLAKE2b-256 eaad828d8a554df8125c5e63d9056c1765705b6e64a139e5cac36fe31d27e859

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepgram_mcp-0.1.1.tar.gz:

Publisher: release.yml on deepgram/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 deepgram_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: deepgram_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 6.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for deepgram_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 eff4904eaee6d424c5201f949e308bc29bd2c2621c74ce38839e2ba180dc4d9a
MD5 7c5d4b42bd1b7e6b4f134cea5f4e8258
BLAKE2b-256 e8f1aeeb3fe25c34d7d23c052bfec9a98f7410bf2b4771de5038f0e94dac6e77

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepgram_mcp-0.1.1-py3-none-any.whl:

Publisher: release.yml on deepgram/mcp

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