# d3p MCP Server

MCP server for the [digital3 agent protocol (d3p)](https://digital3.ai) — exposes all d3p services as MCP tools that any MCP client can call.

Auto-discovers services from the d3p manifest and registers each as a tool, plus protocol-level tools for discovery, compatibility checking, pipeline execution, reputation, and pricing.

## Quick Start

### Install

```bash
pip install d3p-mcp-server
```

Or install from source:

```bash
git clone https://github.com/digital3/d3p-mcp-server.git
cd d3p-mcp-server
pip install -e .
```

### Claude Desktop

Add to your `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`, Windows: `%APPDATA%\Claude\claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "d3p": {
      "command": "d3p-mcp-server",
      "env": {
        "D3P_BASE_URL": "https://labs.digital3.ai",
        "D3P_MOCK_PAYMENTS": "true"
      }
    }
  }
}
```

Or run directly with Python:

```json
{
  "mcpServers": {
    "d3p": {
      "command": "python3",
      "args": ["-m", "d3p_mcp_server"],
      "env": {
        "D3P_MOCK_PAYMENTS": "true"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add d3p -- d3p-mcp-server
```

### SSE Mode (Remote)

```bash
d3p-mcp-server --sse --port 8888
```

## Available Tools

### Service Tools (auto-discovered)

Each d3p service is registered as `d3p_{service_id}`. All accept a JSON string parameter with the service's input fields.

Examples: `d3p_btc-price`, `d3p_search`, `d3p_weather`, `d3p_vibe-check`, etc.

### Protocol Tools

| Tool | Description |
|------|-------------|
| `d3p_list_services` | List all services with pricing and descriptions |
| `d3p_discover` | Search services by capability, price, reputation, latency |
| `d3p_check_compatibility` | Check if two services can be chained (output→input) |
| `d3p_pipeline_execute` | Execute a multi-service pipeline with atomic payments |
| `d3p_pipeline_status` | Check status of a running pipeline |
| `d3p_pipeline_result` | Get final result of a completed pipeline |
| `d3p_pipeline_validate` | Dry-run a pipeline (cost estimate, no execution) |
| `d3p_pipeline_templates` | List pre-built pipeline templates |
| `d3p_reputation` | Get reputation score for a service |
| `d3p_price_quote` | Get dynamic price quote for a service |
| `d3p_protocol_info` | Get protocol configuration info |

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `D3P_BASE_URL` | `https://labs.digital3.ai` | Base URL for d3p services |
| `D3P_MANIFEST_URL` | `{BASE_URL}/api/services/manifest` | Manifest endpoint |
| `D3P_MOCK_PAYMENTS` | `true` | Set `false` for live L402 Lightning payments |
| `D3P_TIMEOUT` | `15` | Request timeout in seconds |

## Examples

### List services
Ask Claude: "What d3p services are available?"

### Get Bitcoin price
Ask Claude: "Use d3p to get the current Bitcoin price in USD"

### Chain services
Ask Claude: "Search for Bitcoin news and then run sentiment analysis on the results using d3p"

### Discover by capability
Ask Claude: "Find d3p services that do text analysis for under 50 sats"

## Architecture

```
Claude Desktop / claude-code / Cursor
    │
    │ MCP (stdio or SSE)
    ▼
d3p MCP Server
    │
    │ HTTPS
    ▼
labs.digital3.ai (d3p protocol)
    │
    │ L402 Lightning
    ▼
autonom rails (payment layer)
```

## Development

```bash
git clone https://github.com/digital3/d3p-mcp-server.git
cd d3p-mcp-server
pip install -e .
d3p-mcp-server --test
```

## License

MIT