# mcpheaven for developers

## Connect

MCP endpoint: `https://mcpheaven.com/mcp` (Streamable HTTP, JSON-RPC). Without a key: public catalog, 120 calls per hour per address. With a key (`Authorization: Bearer mch_…`, free at https://mcpheaven.com/signup): plan quota and private capabilities.

```bash
claude mcp add --transport http mcpheaven https://mcpheaven.com/mcp --header "Authorization: Bearer mch_…"
```

```json
{ "mcpServers": { "mcpheaven": { "url": "https://mcpheaven.com/mcp", "headers": { "Authorization": "Bearer mch_…" } } } }
```

REST: `GET https://mcpheaven.com/api/v1/capabilities?q=<task>` · OpenAPI: https://mcpheaven.com/openapi.json · Server card: https://mcpheaven.com/.well-known/mcp.json

## Tools

### search_capabilities

Search the mcpheaven catalog for services and capabilities that fit a task, e.g. "provision a European cloud server" or "read invoices from Lexware". Returns matching entries with status (planned, beta, available) and a slug for get_capability.

Input schema:

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What the agent needs to get done, in plain language."
    },
    "category": {
      "type": "string",
      "description": "Optional category, e.g. \"Finance\" or \"Cloud\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  },
  "required": [
    "query"
  ]
}
```

### get_capability

Return the details of one catalog entry by its slug.

Input schema:

```json
{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Slug from search_capabilities, e.g. \"hetzner-cloud\"."
    }
  },
  "required": [
    "slug"
  ]
}
```

## Limits

- Anonymous: 120 calls per hour per address, public catalog only.
- Developer: 1,000 calls per month, 2 keys.
- Pro: 50,000 calls per month, 10 keys.
- Team: 250,000 calls per month, 50 keys.