# Jammable MCP Server

> Model Context Protocol server that lets AI agents (Claude, Cursor, Windsurf, agent frameworks) use Jammable directly: search 100,000+ community AI voices, create AI covers, generate text-to-speech, and check results.

- Endpoint: `https://www.jammable.com/api/mcp/mcp` (Streamable HTTP)
- Auth: `Authorization: Bearer jmb_live_...` (Jammable API key, created at https://www.jammable.com/developers/dashboard)
- Human-readable guide: https://www.jammable.com/mcp

## Tools

| Tool | What it does | Cost |
|---|---|---|
| search_voices | Search voices by name/category (music, anime, cartoon, gaming, korean, public figure) | free |
| get_voice | Details for one voice model | free |
| create_cover | Convert a song (public .mp3/.wav URL) into a chosen AI voice | $0.25/min of audio |
| get_cover | Status + result audio URL for a cover | free |
| text_to_speech | Speak up to 2,500 characters in any voice | $0.25/min of audio |
| get_credits | Remaining API credit balance | free |

## Setup

Claude Code:

```
claude mcp add --transport http jammable https://www.jammable.com/api/mcp/mcp \
  --header "Authorization: Bearer jmb_live_YOUR_KEY"
```

Claude Desktop / Cursor / Windsurf (mcp.json):

```json
{
  "mcpServers": {
    "jammable": {
      "url": "https://www.jammable.com/api/mcp/mcp",
      "headers": { "Authorization": "Bearer jmb_live_YOUR_KEY" }
    }
  }
}
```

## Notes

- create_cover requires a publicly accessible audio file URL; YouTube/streaming links are not supported. Users are responsible for having rights to audio they submit.
- Billing: generations cost $0.25 per minute of audio processed, deducted from your API balance after completion; failed jobs are not charged. The Power plan includes $25/month of API credits; top up from the Developer Dashboard.
- REST equivalent: https://www.jammable.com/docs (OpenAPI: https://www.jammable.com/openapi.json)