# Mcpd

> Declaratively define and run required tools across environments, from local development to containerized cloud deployments.

- **Type:** MCP server
- **Install:** `agentstack add mcp-mozilla-ai-mcpd`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [mozilla-ai](https://agentstack.voostack.com/s/mozilla-ai)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [mozilla-ai](https://github.com/mozilla-ai)
- **Source:** https://github.com/mozilla-ai/mcpd
- **Website:** https://mozilla-ai.github.io/mcpd/

## Install

```sh
agentstack add mcp-mozilla-ai-mcpd
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Run your agents, not your infrastructure.

Built by [Mozilla AI](https://mozilla.ai)

📚 [mcpd official docs](https://mozilla-ai.github.io/mcpd/)

---

`mcpd` is a daemon that manages your MCP servers via declarative configuration, exposing them as clean HTTP endpoints. This bridges the gap between your agents and your infrastructure, handling the messy work of lifecycle management, secret injection, and environment promotion so you don't have to.

## ⚙️ How it Works

Under the hood, mcpd spawns MCP servers as STDIO subprocesses and proxies requests over HTTP.

  
    
    
    
  

## 🚀 Quick Start

### Prerequisites

Install the `mcpd` binary first, then install the runtime(s) used by the MCP servers you want to run:

- [**uv**](https://docs.astral.sh/uv/getting-started/installation/) for servers whose package starts with `uvx::`
- [**Node.js / npx**](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) for servers whose package starts with `npx::`, and for `mcpd inspector`
- [**Docker**](https://www.docker.com/products/docker-desktop/) for servers whose package starts with `docker::`, or if you plan to run `mcpd` in Docker

The quick start below uses the `time` server via `uvx`, so `uv` is required for that example.

Optional helpers used in some docs examples:
- `curl` to call the HTTP API
- `jq` to pretty-print JSON responses

If you are building `mcpd` from source or contributing, you will also need [**Go**](https://go.dev/doc/install) (`v1.26.0+` recommended).

### Installation

#### via Homebrew

(Works for both macOS and Linux)

Add the Mozilla.ai tap:

```bash
brew tap mozilla-ai/tap
```

Then install `mcpd`:

```bash
brew install mcpd
```

Or install directly from the cask:

```bash
brew install --cask mozilla-ai/tap/mcpd
```

Please read our docs to install via [GitHub releases](https://mozilla-ai.github.io/mcpd/installation/#via-github-releases) or [local Go Binary build](https://mozilla-ai.github.io/mcpd/installation/#via-local-go-binary-build).

### Using mcpd

```bash
# Initialize a new project and create a new .mcpd.toml file
mcpd init

# Add an MCP server to .mcpd.toml
mcpd add time

# Set the local timezone for the MCP server
mcpd config args set time -- --local-timezone=Europe/London

# Start the daemon in dev mode with debug logging
mcpd daemon --dev --log-level=DEBUG --log-path=$(pwd)/mcpd.log
```

Now that the daemon is running, let's call the `get_current_time` tool provided by the `time` MCP server

```bash
# Check the time
curl -s --request POST \
  --url http://localhost:8090/api/v1/servers/time/tools/get_current_time \
  --header 'Accept: application/json, application/problem+json' \
  --header 'Content-Type: application/json' \
  --data '{
  "timezone": "Europe/Warsaw"
}'
```

API docs will be available at [http://localhost:8090/docs](http://localhost:8090/docs).

## 💡 Why `mcpd`? 

Engineering teams build agents that work locally, then struggle to make them production-ready across environments. mcpd bridges this gap with declarative configuration and secure secrets management.

- Declarative & reproducible – .mcpd.toml defines your tool infrastructure
- Language-agnostic – Python, JS, Docker containers via unified HTTP API
- Dev-to-prod ready – Same config works locally and in containers

## 🏗️ Built for Dev & Production

| Development Workflow                                                              | Production Benefit                                         |
|-----------------------------------------------------------------------------------|------------------------------------------------------------|
| `mcpd daemon` runs everything locally                                             | Same daemon runs in containers                             |
| `.mcpd.toml` version-controlled configs                                           | Declarative infrastructure as code                         |
| Local secrets in `~/.config/mcpd/`                                                | Secure secrets injection via control plane                 |
| `mcpd config export` exports version-control safe snapshot of local configuration | Sanitized secrets config and templates for CI/CD pipelines |

## 📦 SDKs

### `mcpd` SDKs

| Language   | Repository                                                               | Status |
|------------|--------------------------------------------------------------------------|--------|
| Python     | [mcpd-sdk-python](https://github.com/mozilla-ai/mcpd-sdk-python)         | ✅      |
| JavaScript | [mcpd-sdk-javascript](https://github.com/mozilla-ai/mcpd-sdk-javascript) | ✅      |

### `mcpd` plugin SDKs

Plugin SDKs are built using the [mcpd plugin Protocol Buffers specification](https://github.com/mozilla-ai/mcpd-proto).

| Language | Repository                                                                       | Status |
|----------|----------------------------------------------------------------------------------|--------|
| Go       | [mcpd-plugins-sdk-go](https://github.com/mozilla-ai/mcpd-plugins-sdk-go)         | ✅      |
| .NET     | [mcpd-plugins-sdk-dotnet](https://github.com/mozilla-ai/mcpd-plugins-sdk-dotnet) | ✅      |
| Python   | [mcpd-plugins-sdk-python](https://github.com/mozilla-ai/mcpd-plugins-sdk-python) | ✅      |

## 💻 Development

If you are developing `mcpd`, you will need:
- [**Go**](https://go.dev/doc/install) (v1.26.0+ recommended)

Build local code:
```bash
make build
```

Run tests:
```bash
make test
```

Validate Mozilla AI registry (when modifying registry files):
```bash
make validate-registry
```

Run the local documentation site (requires `uv`), dynamically generates command line documentation:
```bash
make docs
```

## 🧩 The Mozilla.ai Stack
`mcpd` is the "Tooling Layer" of the Mozilla.ai ecosystem. These tools are designed to work together or standalone.

| Layer | Tool                                                                       | Function |
|----------|----------------------------------------------------------------------------------|--------|
| Compute       | [llamafile](https://github.com/mozilla-ai/llamafile)         |  Local LLM inference server |
|Interface      | [any-llm](https://github.com/mozilla-ai/any-llm)| Unified Python library for LLM inference |
| Logic     | [any-agent](https://github.com/mozilla-ai/any-agent) | Orchestration and agent loops |
| Tools   | [mcpd](https://github.com/mozilla-ai/mcpd) | **(You are here)** Tool sandbox & router |
| Safety  | [any-guardrail](https://github.com/mozilla-ai/any-guardrail)| Input/Output validation |

## 🤝 Contributing

Please see our [Contributing to mcpd](CONTRIBUTING.md) guide for more information. 

## 📄 License

[Licensed](LICENSE) under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [mozilla-ai](https://github.com/mozilla-ai)
- **Source:** [mozilla-ai/mcpd](https://github.com/mozilla-ai/mcpd)
- **License:** Apache-2.0
- **Homepage:** https://mozilla-ai.github.io/mcpd/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-mozilla-ai-mcpd
- Seller: https://agentstack.voostack.com/s/mozilla-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.