Back to the catalog

Use Uncommon Ear from your AI assistant

Search CC0 music and sound effects without leaving your assistant. Find a track, inspect its license and credit line, play a preview, and link to its source and catalog page.

When you connect, your assistant asks you to sign in to Uncommon Ear once. A free account is all you need, and you can sign in with an email link or with Google. Your assistant then gets read-only access to search tracks.

Endpoint

Add this remote MCP endpoint to an assistant that supports Streamable HTTP. The first time you connect, you sign in to Uncommon Ear with a free account.

If copying is blocked, the endpoint is selected so you can copy it yourself.

Connect an assistant

Claude Code

Run this command in your terminal:

Add the server
claude mcp add --transport http uncommon-ear https://uncommonear.com/mcp

Then sign in once:

  1. Start Claude Code and enter /mcp. Claude Code flags servers that need you to sign in.
  2. Select uncommon-ear and choose to authenticate.
  3. In the browser window that opens, sign in to Uncommon Ear and select Allow.

Add --scope user to make Uncommon Ear available in every project, or --scope project to save it in the project's .mcp.json file so your team gets it too.

For every project
claude mcp add --transport http uncommon-ear --scope user https://uncommonear.com/mcp

To check the connection after you sign in, run the command below, or enter /mcp inside Claude Code.

List servers
claude mcp list

To share the setup with your team, commit a .mcp.json file. The type field is required. Each person on your team signs in once with their own Uncommon Ear account.

.mcp.json
{
  "mcpServers": {
    "uncommon-ear": {
      "type": "http",
      "url": "https://uncommonear.com/mcp"
    }
  }
}

To remove it:

Remove the server
claude mcp remove uncommon-ear

Then ask Claude Code: Find a calm 60 second track for a podcast intro and give me the credit line. Claude Code searches the catalog and returns matching tracks with their license status, a preview link and a ready-to-paste credit line.

Claude

Open Customize > Connectors, select Add, then Add custom connector. Name it Uncommon Ear and enter the endpoint. Then select Connect, sign in to Uncommon Ear, and select Allow.

ChatGPT

In developer mode, add a remote MCP server and use the endpoint. The available connector controls can vary by plan and workspace. Clients that support OAuth sign-in prompt you to sign in to Uncommon Ear automatically.

Cursor

Add a remote MCP server in Cursor and use this mcp.json entry. Clients that support OAuth sign-in prompt you to sign in to Uncommon Ear automatically.

mcp.json
{
  "mcpServers": {
    "uncommon-ear": {
      "url": "https://uncommonear.com/mcp"
    }
  }
}

VS Code

Create or open .vscode/mcp.json, then add this server. Clients that support OAuth sign-in prompt you to sign in to Uncommon Ear automatically.

.vscode/mcp.json
{
  "servers": {
    "uncommon-ear": {
      "type": "http",
      "url": "https://uncommonear.com/mcp"
    }
  }
}

Sign-in and access

  • You need a free Uncommon Ear account. Sign in with an email link or with Google. If you don't have an account yet, signing in creates one.
  • The Allow screen asks whether to let your assistant search Uncommon Ear as you. It can search, look up, and find similar tracks. It can't change your account.
  • Your sign-in lasts up to 30 days. After that, your assistant asks you to sign in again.
  • To end an assistant's access now, open the account menu, select Connected assistants, and select Remove next to it. Deleting your account revokes every assistant's access immediately. Signing out of the website doesn't end MCP access.
  • Limits depend on your plan. Free accounts can make 20 calls per minute and 300 calls per day. Pro accounts can make 60 calls per minute and 20,000 calls per month (a calendar month in UTC), with no daily limit. The limits apply to your account across all of your assistants, and they're shared with the JSON API. Over a limit, a tool returns the error "Too many requests" with the number of seconds to wait. For the monthly limit, the error gives the date the limit resets.

What we record

For each tool call, we record your account, which assistant made the call, the tool, whether it worked, how long it took, and how many results it returned. For searches, we also record the search text. We don't record your IP address or the results. We remove the search text after 90 days and the rest after 400 days. Read the details in the privacy policy.

Tools

search_tracks
Search by query, kind, min_seconds, max_seconds, BPM range, loops_only, and the other site filters. Every word in query must match, so keep it short, such as piano. It searches music unless you set kind to sfx. Filters apply to the whole catalog and total is the full match count. Take limit (1–25; default 10) results at a time and pass the returned cursor back as cursor for the next page.
get_track
Get one track by id.
find_similar
Find similar tracks for an id from search results; set limit when you need fewer than 10. Many tracks have no neighbors yet, and the reply says so.

Example

Ask: Find piano music under 60 seconds.

Your assistant can return matching tracks with duration, BPM, tags, license and terms, a credit line, source page, preview URL, and a link back to Uncommon Ear.

Coming with Pro

Make clips and save to collections.