> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topmediai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TopMediai MCP

> Official Topmediai Model Context Protocol (MCP) server that enables interaction with powerful Text to music generation APIs.

Topmediai Mcp Service Host: [https://mcp.topmediai.com](https://mcp.topmediai.com)

### Cursor

Go to `Cursor` -> `Cursor Settings(Ctrl + Shift + J)` -> `Tools & MCP` -> `Add new MCP Server` to include the following:

```json theme={null}
{
  "mcpServers": {
    "Topmediai": {
      "url": "https://mcp.topmediai.com/mcp",
      "headers": {
        "x-api-key": "insert-your-api-key-here"
      }
    }
  }
}
```

### Available Tools

| tool              | description                                         |
| ----------------- | --------------------------------------------------- |
| `generate-lyrics` | Generate lyrics based on the description            |
| `generate-music`  | Generate music based on descriptive words or lyrics |

### Example usage

Warning: Using these tools may incur costs.

#### 1. generate lyric

<img className="block dark:hidden" src="https://mintcdn.com/zheng/nh3gfLNXehv6JVRu/images/mcp_example1.png?fit=max&auto=format&n=nh3gfLNXehv6JVRu&q=85&s=1e15cda17bfe7365e7880167441ddc1e" alt="TopMediai API Documentation | Innovative Solutions for Developers" width="1041" height="966" data-path="images/mcp_example1.png" />

<img className="hidden dark:block" src="https://mintcdn.com/zheng/nh3gfLNXehv6JVRu/images/mcp_example1.png?fit=max&auto=format&n=nh3gfLNXehv6JVRu&q=85&s=1e15cda17bfe7365e7880167441ddc1e" alt="TopMediai API Documentation | Innovative Solutions for Developers" width="1041" height="966" data-path="images/mcp_example1.png" />

### 2. generate music

<img className="block dark:hidden" src="https://mintcdn.com/zheng/nh3gfLNXehv6JVRu/images/mcp_example2.png?fit=max&auto=format&n=nh3gfLNXehv6JVRu&q=85&s=42ae3decad5528dae0a7fc05ae688441" alt="TopMediai API Documentation | Innovative Solutions for Developers" width="1046" height="867" data-path="images/mcp_example2.png" />

<img className="hidden dark:block" src="https://mintcdn.com/zheng/nh3gfLNXehv6JVRu/images/mcp_example2.png?fit=max&auto=format&n=nh3gfLNXehv6JVRu&q=85&s=42ae3decad5528dae0a7fc05ae688441" alt="TopMediai API Documentation | Innovative Solutions for Developers" width="1046" height="867" data-path="images/mcp_example2.png" />

Click on the audio and file links in the picture to download the corresponding songs and pictures.