# AudD Music Recognition

> AudD Music Recognition is a freemium MCP server for design and media. AudD account tools: usage, plans, API token and one-off song recognition with OAuth scopes. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://docs.audd.io/mcp/
- **MCP Registry name:** io.audd/audd
- **Categories:** design and media, events and entertainment
- **Listing updated:** 2026-11-16

## About

Most of this server is about managing an AudD account, not recognising music at scale. An agent can check how many requests remain in the billing cycle, read per-day usage, fetch or rotate the api_token, list plans and billing history, and see the amount owed for going over the allowance. For song identification it can call the AudD API as the account, with audio passed by URL only.

Access comes through OAuth 2.0 with PKCE and dynamic client registration, and tools whose scope was not granted do not appear to the client at all. Scopes include usage:read, billing:read, billing:pay, api:request, token:read and token:write; dynamically registered clients get a default grant without token:write. Payment tools only create Stripe links that you open and approve in a browser.

The docs caution that rotating the token invalidates the old one at once, and that make_api_request spends real quota and can change stream settings. For repeated recognition they recommend fetching the token once and using the HTTP API or an SDK directly.

## Features

- **Scoped OAuth:** Grant only the scopes a workflow needs; ungranted tools are hidden.
- **Usage statistics:** Billing-cycle total, allowance, remaining requests and daily counts.
- **API token control:** Read the token or rotate it, with the old one failing immediately.
- **Plans and billing:** List plans, payment history and over-allowance amounts.
- **Payment links:** Create Stripe links for plans, renewals or bonus requests, never auto-charging.
- **One-off recognition:** Identify a song from an audio URL as the account.

## Good for

- Ask how many AudD requests are left this cycle
- Plot recent usage and spot spikes
- Set up a project's API token from the account
- Rotate a token that may have leaked
- Prepare a plan-upgrade payment link for approval

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http audd https://mcp.audd.io
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.audd.io
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "audd": {
      "url": "https://mcp.audd.io"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "audd": {
      "type": "http",
      "url": "https://mcp.audd.io"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "audd": {
      "serverUrl": "https://mcp.audd.io"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "audd": {
      "type": "http",
      "url": "https://mcp.audd.io"
    }
  }
}
```

## Tools

- `make_api_request`: Call the AudD API as the account for recognition, lyrics and stream management.
- `get_api_docs`: The official API documentation as markdown by topic.
- `get_profile`: Account email and connected sign-in methods.
- `get_account_status`: Current plan, subscription status, paid-until date and bonus requests.
- `get_usage_stats`: Billing-cycle total, allowance, remaining and per-day counts.
- `get_api_token`: Returns the account api_token.
- `rotate_api_token`: Replaces the api_token; the old one stops working immediately.
- `list_plans`: Available subscription plans with pricing and included requests.
- `get_billing_history`: Recent payments, renewals, extras and bonus purchases.
- `get_amount_owed`: Over-allowance usage accrued this cycle and its cost at renewal.
- `subscribe_to_plan`: Payment link to subscribe to or switch plans.
- `create_renewal_payment`: Payment link to renew, including owed extras.
- `buy_bonus_requests`: Payment link for extra API requests in multiples of 1,000.

## FAQ

### Can the agent charge my card?

No. Payment tools return a Stripe link that you must open and approve in a browser.

### Can I upload an audio file?

No, binary upload is not possible through the tool; pass audio by URL.

### What happens when the token is rotated?

The old token stops working immediately, so anything using it starts failing.

### Should I use it for bulk recognition?

The docs recommend the HTTP API or SDKs for repeated calls, with make_api_request kept for one-off requests.

### Is AudD Music Recognition free?

AudD Music Recognition has a free plan, with paid plans for more usage or features.

### How do I add AudD Music Recognition to Claude Code?

Run this command in your terminal: claude mcp add --transport http audd https://mcp.audd.io

### What are the best alternatives to AudD Music Recognition?

The closest alternatives to AudD Music Recognition are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/audd-music-recognition
