How to integrate AudD MCP with Hermes

Connect Hermes to AudD MCP. Identify this song from an uploaded audio file, find lyrics for this identified track, and more using natural language, with authentication handled for you.

AudD logoAudD
Api Key

AudD is a music recognition service that identifies songs from audio. It also supports lyrics search, stream monitoring, and private music catalogs.

11 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your AudD account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate AudD with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating AudD with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to AudD

Ask your agent to connect to AudD, or simply request any AudD-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new AudD connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to AudD or request any AudD-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the AudD MCP server, and what's possible with it?

The AudD MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your AudD account. It provides structured and secure access to AudD's music recognition, lyrics search, stream monitoring, and private catalog tools, so your agent can identify songs, search lyrics, monitor streams, manage monitored sources, and maintain private catalog entries on your behalf.

  • Audio recognition: Have your agent identify a song from an audio URL, uploaded file, or base64 audio.
  • Long media scanning: Direct your agent to scan selected parts of a long audio or video source and find matching songs.
  • Lyrics search: Let the agent search for lyrics by artist, song title, or lyric text and return available full lyrics.
  • Stream monitoring: Instruct your agent to add, list, update, and delete monitored live audio, radio, Twitch, or YouTube streams, then wait for recognition events.
  • Private music catalogs: Have your agent add or replace songs in your private AudD catalog by fingerprinting an audio URL or uploaded song.

Way Forward

With AudD connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every AudD action and event your agent gets out of the box.

Add Stream

Start persistent recognition for a live audio, radio, Twitch, or YouTube stream; this can consume a paid stream slot billed monthly until deleted.

Delete Stream

Stop recognition and permanently delete one monitored stream, releasing its paid stream slot and stopping its ongoing monthly billing.

Get Stream Callback URL

Return the account-wide callback URL currently configured for AudD stream-recognition events.

List Streams

List every monitored stream configured on the connected AudD account, including its ID, source URL, running state, and long-poll category.

Recognize Audio

Identify one song from the first 12 seconds of an audio URL, uploaded file, or base64 audio; returns null when no song matches and consumes recognition quota.

Recognize Long Media

Scan selected 12-second chunks of a long audio or video URL or file for matching songs on AudD's enterprise host; file uploads are capped at 20 MB, and each scanned chunk is billable after the free allowance, so limit defaults to 1.

Search Lyrics

Search AudD's lyrics index by artist, title, or lyric text and return up to the provider's default 10 matches with full lyrics when available.

Set Stream Callback URL

Replace the account-wide URL that receives AudD stream-recognition callbacks; this persistently affects every monitored stream.

Update Stream URL

Replace the source URL of an existing monitored stream while keeping its account-specific radio ID.

Upsert Custom Catalog Song

Fingerprint a URL or uploaded song into the private catalog under a caller-chosen audio ID; reusing the ID replaces its fingerprint and requires provider-enabled paid access.

Wait for Stream Events

Hold one request for up to 90 seconds waiting for recognition or notification events from a stream long-poll category; use an available event time as since_time on the next call to resume without duplicates.

FAQ

Frequently asked questions

Start with AudD.It takes 30 seconds.

Managed auth, hosted MCP servers, and every AudD tool your agent needs.Free to start.

Start building