MCP server for Media Cloud: measure news attention, list stories, and browse media sources and collections.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"media-cloud-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# media-cloud-mcp An [MCP](https://modelcontextprotocol.io) server for [Media Cloud](https://www.mediacloud.org), the open archive of online news used for media research. It lets an AI assistant measure how much attention news media pay to a topic, compare sources and countries, examine the language of coverage, and find story URLs. This is an independent project, not an official Media Cloud product. It is built on the official [`mediacloud`](https://pypi.org/project/mediacloud/) Python client. ## Setup You need [uv](https://docs.astral.sh/uv/) and a Media Cloud API key. You don't need to install Python or this package yourself: `uvx` downloads whatever is missing the first time the server starts. ### 1. Install uv On macOS or Linux: ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` On Windows: ```powershell powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" ``` Then open a new terminal, so that it can find the `uvx` command. ### 2. Get a Media Cloud API key [Sign in to Media Cloud](https://search.mediacloud.org/sign-in), click the person icon at the top right, choose **Profile**, and copy your API key. ### 3. Add the server to your MCP client For Claude Code, run: ```bash claude mcp add media-cloud --env MC_API_KEY=your-api-key -- uvx media-cloud-mcp ``` For Claude Desktop and other clients that use a JSON configuration, add this to the configuration file. In Claude Desktop, that's `claude_desktop_config.json`, which you can open from **Settings > Developer > Edit Config**. ```json { "mcpServers": { "media-cloud": { "command": "uvx", "args": ["media-cloud-mcp"], "env": { "MC_API_KEY": "your-api-key" } } } } ``` Restart the client after changing its configuration. You don't need to start the server yourself, because the client does that. If you run `uvx media-cloud-mcp` in a terminal, it waits silently for a client to connect, so it can look frozen. Press Ctrl+C to stop it. #…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.