StudioSphere Pulse

by notpaulb

274 downloads
Not rated
GitHub

About

Privacy-first audio intelligence for agents and creative audio workflows. Analyze public audio URLs for BPM, musical key, and waveform shape. Audio is processed ephemerally and not stored; pay per second with no account required for the public UI.

Details

Author
notpaulb
Downloads
274
Categories
Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name StudioSphere Pulse
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

{
  "mcpServers": {
    "studiosphere-pulse": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.studiosphere.space/mcp?api_key=YOUR_PULSE_API_KEY"
      ]
    }
  }
}

start_trial

Start a temporary, email-free Pulse trial. Returns a short-lived private API key with enough banked tokens for one short URL-based v1 analysis. No Stripe Checkout session is created. Store the key in the client or a trusted local environment; do not repost it in public logs, screenshots, GitHub issues, shared chats, or directory examples.

estimate_cost

Get the exact price to analyze an audio file before committing. Always call this first. Returns cost in dollars and a job_estimate_id valid for 30 minutes. Free — never charged.

analyze_track

Run audio analysis on a public audio URL. Requires estimate_cost to be called first (job_estimate_id). Requires PULSE_API_KEY. Before calling, you MUST confirm with the user that they have a lawful basis to submit this audio for analysis. For a user-requested folder, project, playlist, or batch, one confirmation can cover every track in that scope. Returns job_id — poll get_job_status for results.

request_payment_link

Generate a one-time Stripe payment page for users without a Pulse account. Before calling, you MUST confirm with the user that they have a lawful basis to submit this audio for analysis; for a user-requested batch/folder/project, one confirmation can cover that scope. Present the payment_url to the user as a link. Analysis begins automatically after payment. Poll get_job_status with the returned job_id.

get_job_status

Check the status and results of an analysis job. Poll after analyze_track returns job_id, or after the user pays via request_payment_link. Returns full results when status=completed.

get_token_balance

Check the banked token balance for the authenticated Pulse account. Requires PULSE_API_KEY.

list_token_packs

List the available Pulse token packs (tier label, token count, price). Use before purchase_token_pack to show options to the user.

purchase_token_pack

Create a Stripe Checkout session for a Pulse token pack. Returns payment_url — DO NOT submit it programmatically; surface it to the user so they can complete payment in their browser. Once paid, banked tokens are credited automatically. Requires PULSE_API_KEY.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "studiosphere pulse": {
            "studiosphere-pulse": {
                "command": "npx",
                "args": [
                    "mcp-remote@latest",
                    "https://mcp.studiosphere.space/mcp?api_key=YOUR_PULSE_API_KEY"
                ]
            }
        }
    }
}

McpServers

{
    "studiosphere-pulse": {
        "command": "npx",
        "args": [
            "mcp-remote@latest",
            "https://mcp.studiosphere.space/mcp?api_key=YOUR_PULSE_API_KEY"
        ]
    }
}

> Privacy-first audio intelligence over the Model Context Protocol.
> BPM, musical key, and waveform peaks for any public audio URL. Audio is
> processed in memory and never stored. Pay-per-second, no subscription.

MCP Registry
Hosted
Smithery
Glama

Keywords: audio MCP · BPM detection · musical key detection · waveform analysis · music information retrieval · audio intelligence API · remote MCP server · Streamable HTTP transport.

---

What it does

Pulse analyses any public audio URL (or a direct upload, with an account) and returns structured metadata your AI assistant can act on:

- BPM — tempo with confidence and beat count, time-signature inference
- 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 never stored. | Files are downloaded into a temporary directory, analyzed, and deleted in the same job. Pulse never keeps a copy. |
| ✅ 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.

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 |
| 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:

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

Restart Claude Desktop.

Claude Code (CLI)

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:

{
  "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 |
|---|---|---|
| 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. |
| 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 the right to submit the audio.
4. Call analyze_track (banked tokens) or request_payment_link (anonymous one-time payment).
5. Poll get_job_status until terminal (completed, partial, failed).
6. Surface the result.

Pricing is per-second of audio analyzed × per-tool multiplier. Banked-token pricing skips the $0.50 Stripe minimum and the per-job Checkout redirect.

Why agents use Pulse

- Sample-pack tagging and search
- DAW / session preparation
- Remix and mashup compatibility checks
- Licensed music-library enrichment
- Sync and catalog metadata workflows
- Content-creator music selection from approved libraries

Agents must only submit audio when the user confirms rights to analyze it. The analyze_track tool requires an explicit attestation_confirmed: true for this reason.

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 the right 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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.