Skip to main content

Mixcloud MCP Server


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:

  1. auth_url() — returns a link to open in a browser
  2. Open it, allow access, copy the code
  3. 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 with undo=true.
  • favorite_show - Favorite a show, or remove it from favorites with undo=true.
  • repost_show - Repost a show, or remove the repost with undo=true.
  • listen_later - Add a show to Listen Later, or remove it with undo=true.

Upload and edit (token)

  • upload_show - Upload an audio show with optional artwork and metadata; files must be in MIXCLOUD_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_DIR with 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)

Source distribution for mixcloud-mcp-server 0.1.1
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)

Table of built distributions (wheels) for mixcloud-mcp-server 0.1.1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

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