Skip to main content

MCP Server (Beta)

Welcome to the official documentation for the Epidemic Sound Model Context Protocol (MCP) Server (Beta). This guide is designed for developers who want to integrate our extensive, royalty-free music library into their AI-powered applications.

Terms of Service​

The Terms of Service for using the Epidemic Sound MCP Server (Beta) are available here.

Overview​

What is the Epidemic Sound MCP Server (Beta)?​

The Epidemic Sound MCP Server (Beta) is a powerful tool that acts as a bridge between your AI applications and our vast catalog of high-quality music and sound effects. By leveraging the open MCP standard, our ES MCP server allows AI agents to intelligently and dynamically search for, discover, and retrieve information about our music in real-time. This enables you to build applications that can seamlessly find the perfect soundtrack for any context, whether for a video, a game, a podcast, or any other creative project.

The Epidemic Sound MCP server is designed to be developer-friendly, providing a simple and efficient way to interact with our platform and ensuring compatibility with a wide range of AI development environments and tools.

Getting Started​

Remote Server​

Epidemic Sound hosts an MCP server that’s available at https://www.epidemicsound.com/a/mcp-service/mcp. The Epidemic Sound MCP server uses OAuth Dynamic Client Registration to connect MCP clients as per the MCP spec.

Authentication & Setup​

Connecting to the Epidemic Sound MCP Server uses an OAuth flow that links directly to your Epidemic Sound account. This ensures a secure and seamless integration. You must be logged into www.epidemicsound.com to authenticate.

Allowlist of client redirect URIs​

Epidemic Sound maintains an allowlist of vetted MCP client redirect URIs to protect our users from malicious phishing attacks. If there’s an MCP client application that you want to allowlist, email us at mcp@epidemicsound.com.

Bearer token (coming soon)​

We are currently working on allowing authorization via bearer tokens to enable developers to build agentic software.

Connecting with AI Clients​

You can connect to the Epidemic Sound MCP Server from various AI-powered tools that support custom MCP integrations.

Cursor​

Cursor provides native support for custom MCP servers. Follow these steps to connect:

  1. Open Settings: In Cursor, navigate to Settings > MCP.
  2. Click the New MCP server button. This will open a configuration file named mcp.json.
  3. Configure the Server: Add the following JSON configuration.
{
  "mcpServers": {
    "epidemic-sound": {
      "url": "https://www.epidemicsound.com/a/mcp-service/mcp"
    }
  }
}
  1. In the MCP settings tab, you will now see your newly configured server. Click the Connect button.
  2. Authorize Access: A browser tab will open, prompting you to login with your Epidemic Sound account.
  3. Start Querying: Once connected, the toggle next to the server name will be active. You can now begin making requests to the Epidemic Sound MCP server directly from Cursor prompts!

Available Tools & Usage​

The primary purpose of the MCP server is to give your AI agent the ability to explore our music catalog. The agent can "introspect" our GraphQL schema to understand what queries and data types are available, such as playlists and tracks.

FAQ​

Coming soon.

Reach out to us​

Do you have questions or feedback on the Epidemic Sound MCP Server (Beta)? Email us at mcp@epidemicsound.com or join our Discord server.