Resemble AI MCP server

Resemble AI MCP Server

Official MCP server exposing Resemble AI documentation as resources and tools. Connect to Cursor, Claude Code, or any MCP-compatible client to enable your coding assistant to access Resemble AI docs during development.

Overview

This is the official Resemble AI MCP server. It implements the Model Context Protocol (stdio transport) to serve documentation from docs/pages/ as queryable resources. The server aggregates docs by topic and provides full-text search across all MDX files.

What it provides:

• Topic-based documentation aggregation (13 topics: voice-cloning, text-to-speech, agents, etc.)
• Full-text search across all MDX documentation pages
• OpenAPI 3.0 spec with exact request/response schemas for code generation
• Direct page and endpoint access

Once connected, your coding assistant can query Resemble AI documentation programmatically. You can vibe code complete applications—your assistant has instant access to guides, tutorials, and exact API schemas for accurate code generation.

Quick Start

1. Clone & Install

git clone https://github.com/resemble-ai/resemble-mcp.git
cd resemble-mcp

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

2. Configure MCP Client

Cursor: Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "resemble-ai-docs": {
      "command": "/path/to/resemble-mcp/venv/bin/python",
      "args": ["/path/to/resemble-mcp/server.py"]
    }
  }
}

Claude Code / Claude Desktop: Add to ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or equivalent location for your OS:

{
  "mcpServers": {
    "resemble-ai-docs": {
      "command": "/path/to/resemble-mcp/venv/bin/python",
      "args": ["/path/to/resemble-mcp/server.py"]
    }
  }
}

Note: Use absolute paths. Replace /path/to/resemble-mcp with your actual path.

3. Restart Client

Restart your MCP client to load the server. Tools will be available after restart.

Available Tools

resembledocslookup

Returns aggregated documentation for a topic. Accepts topic ID and returns all related pages concatenated.

Parameters:

• topic (string, required): One of: voice-cloning, text-to-speech, speech-to-speech, speech-to-text, getting-started, voice-design, streaming, detect, agents, sdks, projects-clips, audio-tools, ssml

Returns: Markdown content with all pages for the topic.

resemble_search

Full-text search across all documentation pages. Returns matching pages with snippets.

Parameters:

• query (string, required): Search query
• limit (integer, optional): Max results (default: 5)

Returns: List of matching pages with titles, paths, and content snippets.

resemblegetpage

Retrieves a specific documentation page by path.

Parameters:

• path (string, required): Page path relative to docs/pages/ (e.g., getting-started/quickstart)

Returns: Full page content in Markdown.

resemblelisttopics

Lists all available topic IDs with descriptions.

Returns: Markdown list of topics.

resembleapiendpoint

Get detailed OpenAPI specification for a specific API endpoint. Returns exact request/response schemas, parameters, and types.

Parameters:

• method (string, required): HTTP method (GET, POST, PUT, PATCH, DELETE)
• path (string, required): API endpoint path (e.g., /synthesize, /voices)

Returns: Endpoint specification with schemas, parameters, and response formats.

resembleapisearch

Shortened. The full README is on GitHub.