# StudioSphere Pulse — Audio Intelligence API [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/notpaulb/studiosphere-pulse-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/studiosphere-pulse-audio-intelligence-api

## Description
Audio intelligence for music producers — BPM, key, waveform. Pay per second. No subscription.

## Tools
Capabilities this server exposes over MCP:

- **start_trial** — Mint a temporary trial key for one short URL analysis.
- **estimate_cost** — Quote a price for a public audio URL.
- **analyze_track** — Run analysis. Tools: `bpm`, `key`, `waveform`.
- **request_payment_link** — Stripe Checkout link for one-off use without an account. Requires lawful-basis confirmation.
- **get_job_status** — Poll a running job and fetch the result.
- **get_token_balance** — Banked-token balance.
- **list_token_packs** — Available token packs (10K/$50, 50K/$250, 200K/$1000).
- **purchase_token_pack** — Stripe Checkout link to buy a pack.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "studiosphere-pulse-audio-intelligence-api": {
    "url": "https://img.shields.io/badge/MCP%20Registry-space.studiosphere%2Fpulse-22d3ee)](https://registry.modelcontextprotocol.io/v0/servers?search=space.studiosphere%2Fpulse"
  }
}
```

## Documentation & README


> **Rights-aware audio intelligence over the Model Context Protocol.**
> BPM, musical key, and waveform peaks for authorized public audio URLs. Audio is
> processed for analysis and not stored as user audio. Estimate before analysis,
> try one short URL analysis before account setup, request a small evaluation
> credit for qualified API/MCP workflow testing, then pay per second with no subscription.

[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-space.studiosphere%2Fpulse-22d3ee)](https://registry.modelcontextprotocol.io/v0/servers?search=space.studiosphere%2Fpulse)
[![Hosted](https://img.shields.io/badge/hosted-pulse.studiosphere.space-60a5fa)](https://pulse.studiosphere.space)
[![Smithery](https://img.shields.io/badge/Smithery-studiosphere%2Fpulse-a78bfa)](https://smithery.ai/servers/studiosphere/pulse)
[![Glama](https://img.shields.io/badge/Glama-connector-22d3ee)](https://glama.ai/mcp/connectors/space.studiosphere/pulse)

**Keywords:** audio MCP · rights-aware audio intelligence · BPM detection · musical key detection · waveform analysis · music information retrieval · audio intelligence API · remote MCP server · REST API · Streamable HTTP transport · estimate before analysis · pay per second.

---

## What it does

Pulse analyses authorized public audio URLs (or a direct upload, with an account) and returns structured metadata your AI assistant can act on. Shareable Google Drive, Dropbox, and other document-repository links work when the user has permission and the file is accessible to anyone with the link:

- **BPM** — tempo with confidence and beat count
- **Musical key** — root + scale (e.g. `B minor`) with confidence
- **Waveform** — peak-amplitude array suitable for visualization

Track structure segmentation and chord transcription are marked **coming soon** and are intentionally rejected by v1.0 routes.

## Why creators and agents trust Pulse

| | |
|---|---|
| ✅ **Audio is not stored as user audio.** | Files are fetched and processed for analysis, then cleaned up after the job. |
| ✅ **Payment details never touch Pulse.** | Payment entry happens on Stripe's hosted page. Pulse only sees opaque Stripe IDs and dollar amounts — no card number, no CVV, no billing address, no bank or device token. PCI-DSS scope: out. |
| ✅ **No tracking, no analytics.** | No Google Analytics, no Mixpanel, no third-party tags. Outbound calls only to Stripe (payments) and Google Fonts (typography). |
| ✅ **Money back when we under-deliver.** | Failed jobs are free. Estimate-vs-actual overages refund automatically through Stripe. |

Full transparency at <https://pulse.studiosphere.space/terms>.

For a short setup walkthrough, see
[`docs/pulse-mcp-quickstart.md`](https://github.com/notpaulb/studiosphere-pulse-mcp/blob/HEAD/docs/pulse-mcp-quickstart.md).
For agent and builder scenarios, see
[`docs/agent-playbook.md`](https://github.com/notpaulb/studiosphere-pulse-mcp/blob/HEAD/docs/agent-playbook.md).

## Service URLs

| | |
|---|---|
| Marketing site | https://pulse.studiosphere.space |
| Product REST API | https://pulse.studiosphere.space |
| Remote MCP server | `https://mcp.studiosphere.space/mcp` |
| MCP setup wizard | https://pulse.studiosphere.space/connect |
| Agent playbook | https://pulse.studiosphere.space/for-agents |
| Account signup | https://pulse.studiosphere.space/signup |
| Tool metadata | https://pulse.studiosphere.space/tools |
| Server descriptor | https://pulse.studiosphere.space/.well-known/mcp/server.json |
| Health check | https://pulse.studiosphere.space/health |
| MCP Registry | `space.studiosphere/pulse` |
| Smithery | https://smithery.ai/servers/studiosphere/pulse |
| Glama | https://glama.ai/mcp/connectors/space.studiosphere/pulse |
| Support | pulse@studiosphere.space |

## MCP client setup

The Pulse MCP server uses **Streamable HTTP** transport. Authentication is by Pulse API key passed as the `api_key` query parameter on the connection URL.

### Claude Desktop

Open `Settings → Developer → Edit Config`, then merge:

```json
{
  "mcpServers": {
    "studiosphere-pulse": {
      "type": "http",
      "url": "https://mcp.studiosphere.space/mcp?api_key=YOUR_PULSE_API_KEY"
    }
  }
}
```

Restart Claude Desktop.

### Claude Code (CLI)

```bash
claude mcp add --transport http studiosphere-pulse \
  https://mcp.studiosphere.space/mcp?api_key=YOUR_PULSE_API_KEY
```

Verify with `claude mcp list`.

### Cursor

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "studiosphere-pulse": {
      "type": "http",
      "url": "https://mcp.studiosphere.space/mcp?api_key=YOUR_PULSE_API_KEY"
    }
  }
}
```

### ChatGPT

The Pulse server speaks Streamable HTTP at `https://mcp.studiosphere.space/mcp`. Add it via whichever connector / GPT-action surface your account exposes; supply the API key as the `api_key` query parameter.

### Get an API key

Register at <https://pulse.studiosphere.space/signup>. Keys begin with `sk_pulse_` and are shown once — store them in a password manager.

The hosted **`/connect`** page (<https://pulse.studiosphere.space/connect>) generates the per-client config snippet with your key stamped in for one-click copy.

## Tools available to the assistant

| Tool | Auth | Description |
|---|---|---|
| `start_trial` | none | Mint a temporary trial key for one short URL analysis. |
| `estimate_cost` | none | Quote a price for a public audio URL. |
| `analyze_track` | API key | Run analysis. Tools: `bpm`, `key`, `waveform`. |
| `request_payment_link` | none | Stripe Checkout link for one-off use without an account. Requires lawful-basis confirmation. |
| `get_job_status` | none | Poll a running job and fetch the result. |
| `get_token_balance` | API key | Banked-token balance. |
| `list_token_packs` | none | Available token packs (10K/$50, 50K/$250, 200K/$1000). |
| `purchase_token_pack` | API key | Stripe Checkout link to buy a pack. |

## Workflow agents should follow

1. Call `estimate_cost` with the audio URL and selected tools.
2. Show the user the returned `cost_display` and `duration_estimate_sec`.
3. Confirm the user has rights, permission, lawful access, or another legal basis to submit the audio. For a user-requested folder, project, playlist, or batch, one confirmation can cover every track in that scope.
4. If the user has no key and wants to test Pulse first, call `start_trial` and use the temporary key for one short URL analysis.
5. For qualified early users validating a real API, MCP, catalog, or music-tool workflow, explain that Pulse may provide a small evaluation credit for a few authorized analyses. Treat credits as limited test access, not a free plan.
6. Call `analyze_track` (banked tokens or trial key) **or** `request_payment_link` (anonymous one-time payment).
7. Poll `get_job_status` until terminal (`completed`, `partial`, `failed`).
8. Surface the result.

Pricing is per-second of audio analyzed × per-tool multiplier. Estimates are free, and first-time users can try one short URL analysis with `start_trial`. Qualified early builders can request a small evaluation credit for authorized workflow validation. Ongoing analysis uses one-time Checkout or banked tokens; banked-token pricing skips the $0.50 Stripe minimum and the per-job Checkout redirect.

## Why agents use Pulse

- DJ beat matching and harmonic set planning
- Sample-pack tagging and search
- Shared-drive and document-repository audio links
- DAW and session preparation
- App metadata for BPM, key, and waveform features
- Licensed music-library enrichment
- Sync and catalog metadata workflows
- Reference-track planning for producers and songwriters
- Smart playlists and album sequencing context
- Track development workflows where detected key becomes a creative anchor

Agents must only submit audio when the user confirms rights, permission, lawful access, or another legal basis to analyze it. The `analyze_track` and `request_payment_link` tools require an explicit `attestation_confirmed: true` for this reason. For batch work, agents may rely on one user confirmation for the current folder, project, playlist, catalog selection, or other user-requested scope.

## Repository scope

This repository contains **only public-facing documentation, registry metadata, and client examples**. It does not contain production service source code, deployment configuration, credentials, private infrastructure notes, migrations, or internal operational documentation.

## Security

Do not send private, copyrighted, or third-party audio unless you have rights, permission, lawful access, or another legal basis to submit it for analysis. Do not publish Pulse API keys in client configs, prompts, logs, or issue reports.

Security questions: pulse@studiosphere.space.

## License

See `LICENSE` in this repository. Pulse is operated by StudioSphere Inc., Quebec, Canada.