An MCP server for the Mixcloud API. Any MCP client can drive it: search and browse shows, follow/favorite/repost, and upload or edit your own shows — including scheduled publishing.
Installation
uv tool install mixcloud-mcp-server
Check the installation:
mixcloud-mcp-server --print-config # resolved paths and which credentials exist, no secrets
mixcloud-mcp-server --version
Client setup
The server speaks stdio. The commands below use uvx, which runs the server straight from PyPI without a separate install.
Claude Code
claude mcp add mixcloud -- uvx mixcloud-mcp-server
Codex CLI
codex mcp add mixcloud -- uvx mixcloud-mcp-server
OpenCode
opencode mcp add mixcloud -- uvx mixcloud-mcp-server
Or manually in opencode.json:
{
"mcp": {
"servers": {
"mixcloud": {
"type": "local",
"command": ["uvx", "mixcloud-mcp-server"]
}
}
}
}
Pi
Pi reads MCP servers through the pi-mcp-adapter package:
pi install npm:pi-mcp-adapter
pi mcp add mixcloud -- uvx mixcloud-mcp-server
Use -l to write the entry into the project configuration instead of the user-level one. Pass
the env file with --env MIXCLOUD_ENV_FILE=....
Hermes Agent
hermes mcp add mixcloud --command uvx --args mixcloud-mcp-server
In .hermes/config.yaml recommended to set Hermes Agent's env file:
mcp_servers:
mixcloud:
command: uvx
args: ["mixcloud-mcp-server"]
env:
MIXCLOUD_ENV_FILE: "/home/you/.config/mixcloud-mcp-server/.env"
Then check with hermes mcp list.
Any other client
Run uvx mixcloud-mcp-server and pass MIXCLOUD_ENV_FILE in its environment.
Configuration
| Variable | Default | Purpose |
|---|---|---|
MIXCLOUD_ENV_FILE |
$XDG_CONFIG_HOME/mixcloud-mcp-server/.env (~~/.config/…) |
Token store: loaded at startup, written by exchange_code |
MIXCLOUD_UPLOAD_DIR |
$XDG_DATA_HOME/mixcloud-mcp-server/uploads (~~/.local/share/…) |
The only directory uploads may read files from |
MIXCLOUD_CLIENT_ID |
— | OAuth app id, needed once for authorization |
MIXCLOUD_CLIENT_SECRET |
— | OAuth secret, needed once for authorization |
MIXCLOUD_TOKEN |
— | Access token; written for you by exchange_code |
Authorization
Go to https://www.mixcloud.com/developers/create/ and create an app. You will get the CLIENT ID and CLIENT SECRET, write them in your .env.
Ask the agent:
auth_url()— returns a link to open in a browser- Open it, allow access, copy the code
exchange_code(code)— stores the token in the env file and never returns it
check_token() verifies the token; clear_token() forgets it locally. Mixcloud exposes no
revoke endpoint.
Tools
Read (no token)
search- Search shows, users, or tags by query; supports result type and pagination.get_object- Fetch a show, user, tag, or city by Mixcloud key or URL; optionally include metadata or authenticated fields.get_show- Fetch a show's key details, including its description, play and favorite counts, and tags.get_user- Fetch a user profile by key or URL.get_tag- Fetch a genre, city, or a genre combined with a city.list_connection- List an object's followers, following, favorites, shows, or listens; supports pagination and date filters.user_shows- List a user's shows with pagination and optional date filters.browse- List site-wide popular, hot, or new shows.genre_shows- List shows for a genre using one of the lists available for that tag.embed_html- Generate the HTML player embed for a show, with optional size and color.oembed- Get oEmbed data for a Mixcloud show URL.
Account actions (token)
me- Fetch the authorized user's profile; optionally include metadata.follow_user- Follow a user, or unfollow them withundo=true.favorite_show- Favorite a show, or remove it from favorites withundo=true.repost_show- Repost a show, or remove the repost withundo=true.listen_later- Add a show to Listen Later, or remove it withundo=true.
Upload and edit (token)
upload_show- Upload an audio show with optional artwork and metadata; files must be inMIXCLOUD_UPLOAD_DIR, and visibility defaults to unlisted.edit_show- Edit an uploaded show’s metadata, artwork, or visibility; tags, sections, and hosts are replaced wholesale when supplied.
OAuth
auth_url- Generate the Mixcloud authorization URL; optionally specify a redirect URI.exchange_code- Exchange an OAuth code for an access token, then save the token locally without revealing it.check_token- Check whether the saved access token is valid and identify the authorized account.clear_token- Forget the access token locally; optionally remove it from the env file (does not revoke access on Mixcloud).
Objects are addressed by Mixcloud key: shows /username/show-name/, users /username/,
tags /genres/funk/, cities /genres/city:athens/. Full URLs are accepted everywhere a key is.
Safety
- Uploads are sandboxed to
MIXCLOUD_UPLOAD_DIRwith an extension and size allowlist, so a prompt-injected path cannot exfiltrate arbitrary files from the machine. - The access token is sent as a query parameter, so it is never logged and never included in
error messages. Tools return a masked preview (
...abcd) only. - The client secret is read from the environment and never returned to the model.
- Redirects are not followed for authenticated calls, so a token cannot be replayed to another host.
- If you don't use some tools, it's recommended to turn them off in your agent.
Metadata
Release files for mixcloud-mcp-server 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mixcloud_mcp_server-0.1.1.tar.gz | 141.2 kB | Without provenance | Details for mixcloud_mcp_server-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mixcloud_mcp_server-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for mixcloud_mcp_server-0.1.1-py3-none-any.whl |
Total release size: 161.1 kB
Release files / mixcloud_mcp_server-0.1.1.tar.gz
| Download URL | mixcloud_mcp_server-0.1.1.tar.gz |
|---|---|
| Size | 141.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a4492a6a46f0457cc5bac41a2d32399d2ed87f3b49e124f3648398c354aa453d
|
|
BLAKE2b-256 checksum How to use checksums |
325530b807fa2f29ebef210453e285933c5b63887a12ca8caff32a97a2761091
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mixcloud_mcp_server-0.1.1-py3-none-any.whl
| Download URL | mixcloud_mcp_server-0.1.1-py3-none-any.whl |
|---|---|
| Size | 19.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4f012efc90bf652e615849531317d7bc1718abf54cd76f6fbf71cdb69a1f77dc
|
|
BLAKE2b-256 checksum How to use checksums |
4dbf49b64e49c2da0de502b1b3d541442b3989eb13954b90ffb1b5e39e4523b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for mixcloud-mcp-server 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.