Metadata-Version: 2.4
Name: beatlyze-mcp
Version: 0.1.0
Summary: MCP server for the Beatlyze audio analysis API — analyse audio with AI agents.
License: MIT
Project-URL: Homepage, https://beatlyze.dev
Project-URL: Repository, https://github.com/mg0024/beatlyze-analyzer
Keywords: mcp,audio,music,analysis,bpm,beatlyze,claude
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: httpx>=0.27.0
Dynamic: license-file

# Beatlyze MCP Server

Use the [Beatlyze](https://beatlyze.dev) audio analysis API directly from Claude, Cursor, or any MCP-compatible AI agent.

## Tools

| Tool | Description |
|---|---|
| `analyze_url` | Submit an audio URL, wait for result (BPM, key, energy, mood, genre, sections) |
| `get_analysis` | Check status / retrieve result for a job_id |
| `get_usage` | Check your monthly usage and limits |

## Setup

**1. Get a free API key** at [beatlyze.dev](https://beatlyze.dev)

**2. Add to Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "beatlyze": {
      "command": "uvx",
      "args": ["beatlyze-mcp"],
      "env": {
        "BEATLYZE_API_KEY": "bz_your_key_here"
      }
    }
  }
}
```

**3. Or run directly:**

```bash
pip install beatlyze-mcp
BEATLYZE_API_KEY=bz_your_key_here python -m server
```

## Example

Ask Claude:
> "Analyse this track: https://example.com/mytrack.mp3 — what's the BPM and key?"

Claude will call `analyze_url`, wait for the result, and tell you:
> "The track is 128.4 BPM in A minor, with high energy (0.78) and mood tags: energetic, dark."

## Environment variables

| Variable | Required | Default |
|---|---|---|
| `BEATLYZE_API_KEY` | Yes | — |
| `BEATLYZE_API_BASE` | No | `https://api.beatlyze.dev` |
