H-ear MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@H-ear MCP Serverclassify the bird species in this recording"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
H-ear MCP Server
AI-powered sound classification for Claude. Identify sounds, detect noise events, and classify audio across 7,000+ sound classes — from urban noise to bird species.
H-ear connects Claude to the H-ear World audio classification API via the Model Context Protocol.
Quick Start
npx @h-ear/mcp-server --key YOUR_API_KEYThat's it. Claude now has 14 tools (classification, account, webhooks), a live status resource, and a guided classification prompt.
Related MCP server: soundgrep
Tools
Tool | Auth | Description |
| Key | Classify audio from a file or URL. Async submit + poll. Large files auto-chunked. |
| Key | Batch classify up to 50 files at once. |
| None | Browse 521+ sound classes across 3 taxonomies (7,000+ including species). |
| None | API liveness check — status, version, deployment timestamp. |
| Key | API quota: minutes used, calls today, remaining balance. |
| Key | Recent classification job history with pagination. |
| Key | Detailed job result with all detected sound events. |
| Bearer | Create enterprise webhook with event/taxonomy/tier filters. Returns signing secret once. |
| Bearer | List all enterprise webhook registrations. |
| Bearer | Get webhook details including filter config and delivery stats. |
| Bearer | Update webhook URL, events, status (active/paused), or filters. |
| Bearer | Permanently delete a webhook registration. |
| Bearer | Send a test.ping event to verify connectivity and signing. |
| Bearer | Delivery audit trail with response status and timing. |
Plus:
Resource
h-ear://status— live API status with taxonomies and class countsPrompt
classify-audio— guided workflow with configurable detail level
Supported Audio
Formats | Max Size | Max Duration |
MP3, WAV, FLAC, OGG, M4A | 25 MB (auto-chunked above) | 10 minutes |
Files over 25 MB are automatically split into overlapping chunks using ffmpeg, classified in parallel, then merged with deduplication.
Taxonomies
Taxonomy | Classes | Use Case |
| 521 | General sound classification (default) |
| 527 | Extended general classification |
| 6,522 | Bird species identification |
Authentication
Get an API key from h-ear.world (Enterprise plan). Pass it via:
Environment variable:
HEAR_API_KEYCLI flag:
--key YOUR_KEYOAuth 2.1 + PKCE (automatic via claude.ai Connectors Directory — handled by your MCP client)
Two tools (healthCheck, listClasses) work without authentication.
Transport
Transport | Endpoint |
stdio (npm) |
|
Streamable HTTP |
|
Documentation
Tool Reference — all 7 tools with schemas and parameters
Examples — real-world use cases with prompts
Authentication — API keys, OAuth, Enterprise tiers
Configuration — Claude Desktop, Claude Code, claude.ai setup
Troubleshooting — common issues and solutions
Links
OpenClaw Skill (WhatsApp, Telegram, Slack, Discord, Teams)
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Audio for your agent: transcribe, speak, translate, summarise, plus sound effects and music.
Transcribe audio & video to text for AI agents: 100+ languages, speaker labels, webhooks.
Video, audio, and image processing for AI agents: convert, transcribe, upscale - 150+ operations.
Transcribe audio and video with Speechmatics speech-to-text from Claude and any MCP client.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables Claude to speak in 70+ languages, including pronunciation, audio flashcards, and full language lessons with tutor personas.41MIT
- AlicenseNot gradedqualityDmaintenanceEnables semantic search of local audio samples by describing sounds, MIDI generation, stem separation, and other music production tools from Claude Desktop.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables chat-driven audio analysis and enhancement using local Claude, including denoising, EQ, compression, and loudness normalization, with an A/B viewer for synchronized comparison.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables automated sound design spotting from Claude Code: analyze video, generate cue sheets, search or generate SFX, and export DAW-synchronized stems.0MIT