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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
907955b48130f57d91a81342f1adeeb7a37153d042e1e7affc8fc85f90e3bf54
|
|
| MD5 |
0494a79de18d3e08db17eb399f53eb82
|
|
| BLAKE2b-256 |
eaad828d8a554df8125c5e63d9056c1765705b6e64a139e5cac36fe31d27e859
|
Provenance
The following attestation bundles were made for deepgram_mcp-0.1.1.tar.gz:
Publisher:
release.yml on deepgram/mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
deepgram_mcp-0.1.1.tar.gz -
Subject digest:
907955b48130f57d91a81342f1adeeb7a37153d042e1e7affc8fc85f90e3bf54 - Sigstore transparency entry: 1234047918
- Sigstore integration time:
-
Permalink:
deepgram/mcp@b5d2f5c0efb19012c5e2773c5981029d77bab5d7 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/deepgram
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@b5d2f5c0efb19012c5e2773c5981029d77bab5d7 -
Trigger Event:
push
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eff4904eaee6d424c5201f949e308bc29bd2c2621c74ce38839e2ba180dc4d9a
|
|
| MD5 |
7c5d4b42bd1b7e6b4f134cea5f4e8258
|
|
| BLAKE2b-256 |
e8f1aeeb3fe25c34d7d23c052bfec9a98f7410bf2b4771de5038f0e94dac6e77
|
Provenance
The following attestation bundles were made for deepgram_mcp-0.1.1-py3-none-any.whl:
Publisher:
release.yml on deepgram/mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
deepgram_mcp-0.1.1-py3-none-any.whl -
Subject digest:
eff4904eaee6d424c5201f949e308bc29bd2c2621c74ce38839e2ba180dc4d9a - Sigstore transparency entry: 1234048067
- Sigstore integration time:
-
Permalink:
deepgram/mcp@b5d2f5c0efb19012c5e2773c5981029d77bab5d7 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/deepgram
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@b5d2f5c0efb19012c5e2773c5981029d77bab5d7 -
Trigger Event:
push
-
Statement type: