@totalaudiopromo/tap-mcp

MCP server for Total Audio Promo -- the first music PR tool with programmatic access.

Exposes 14 tools and 3 resources via the Model Context Protocol, giving AI agents full access to the music PR campaign lifecycle.

Tools

| Tool | Description | | ---------------------- | ------------------------------------------------------------ | | tap_list_campaigns | List campaigns with optional status filter | | tap_get_campaign | Get campaign details with contact counts and pitch stats | | tap_list_contacts | List contacts with filters (status, genre, BBC-only, search) | | tap_search_contacts | Search contacts by name, outlet, genre, or BBC station | | tap_contact_insights | Get enrichment and relationship insights for a contact | | tap_draft_pitch | Generate AI-drafted pitches (subject, body, variants) | | tap_log_outcome | Log campaign outcomes (replied, coverage, playlist, etc.) | | tap_get_action_queue | Get today's prioritised action queue |

Resources

| URI | Description | | ----------------- | ---------------------------- | | tap://campaigns | Browse all campaigns as JSON | | tap://contacts | Browse all contacts as JSON | | tap://artists | Browse all artists as JSON |

Setup

Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "tap": {
      "command": "npx",
      "args": ["@totalaudiopromo/tap-mcp"],
      "env": {
        "TAP_SUPABASE_URL": "your-supabase-url",
        "TAP_SUPABASE_KEY": "your-service-role-key"
      }
    }
  }
}

From source

{
  "mcpServers": {
    "tap": {
      "command": "npx",
      "args": ["tsx", "packages/tap-mcp/src/index.ts"],
      "env": {
        "TAP_SUPABASE_URL": "your-supabase-url",
        "TAP_SUPABASE_KEY": "your-service-role-key"
      }
    }
  }
}

Environment Variables

| Variable | Description | | ------------------ | ------------------------- | | TAP_SUPABASE_URL | Supabase project URL | | TAP_SUPABASE_KEY | Supabase service role key |

REST API

TAP also has a REST API with 7 endpoints for contacts, enrichment, validation, and API key management. See the developer docs and OpenAPI spec.

Licence

MIT