# StudioSphere Pulse

Privacy-first audio intelligence for agents and creators. Analyze authorized public audio URLs for BPM, musical key, waveform peaks, pricing, token balance, and Stripe checkout workflows. Audio is pr…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add studiosphere/pulse

# Browse available tools
npx -y smithery tool list studiosphere/pulse

# Get full schema for a tool
npx -y smithery tool get studiosphere/pulse estimate_cost

# Call a tool
npx -y smithery tool call studiosphere/pulse estimate_cost '{}'
```

## Direct MCP Connection

Endpoint: `https://pulse--studiosphere.run.tools`

**Required config:**
- `api_key` (query) — Pulse API key. Get one at pulse.studiosphere.space/signup.

## Tools (7)

- `estimate_cost` — Get the exact price to analyze an audio file before committing. Always call this first. Returns cost in dollars and a j…
- `analyze_track` — Run audio analysis on a public audio URL. Requires estimate_cost to be called first (job_estimate_id). Requires PULSE_A…
- `request_payment_link` — Generate a one-time Stripe payment page for users without a Pulse account. Before calling, you MUST confirm with the us…
- `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 re…
- `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 t…
- `purchase_token_pack` — Create a Stripe Checkout session for a Pulse token pack. Returns payment_url — DO NOT submit it programmatically; surfa…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get studiosphere/pulse <tool-name>
```