trackmcp
Back to directory
O-mega-Enterprise

suprsonic-mcp

View on GitHub

Suprsonic MCP server. One API key, 17 capabilities for your AI agent. Works with Claude Desktop, Cursor, VS Code, ChatGPT.

0 stars JavaScriptOthers Updated Apr 30, 2026
ai-agentmcpmodel-context-protocolsearchtoolsunified-apiweb-scrapingsuprsonic

Documentation

@suprsonic/mcp

MCP server for Suprsonic. Gives any AI agent dozens of capabilities through one connection.

Quick Start

bash
SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Get your API key at suprsonic.ai/app/apis.

Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

json
{
  "mcpServers": {
    "suprsonic": {
      "command": "npx",
      "args": ["-y", "@suprsonic/mcp"],
      "env": {
        "SUPRSONIC_API_KEY": "omk_your_key"
      }
    }
  }
}

Cursor / VS Code

Add to `.cursor/mcp.json` or VS Code MCP config:

json
{
  "suprsonic": {
    "command": "npx",
    "args": ["-y", "@suprsonic/mcp"],
    "env": {
      "SUPRSONIC_API_KEY": "omk_your_key"
    }
  }
}

Remote HTTP (for Claude API, ChatGPT, programmatic agents)

bash
SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp --http --port 3100

Then connect to `http://localhost:3100/mcp`.

Available Tools

ToolWhat it does
searchSearch the web (AI synthesis, SERP, or both)
scrapeExtract content from any URL as Markdown
profilesFind professional profiles by name or LinkedIn URL
emailsFind professional email addresses
imagesGenerate images from text prompts
ttsConvert text to speech
sttTranscribe audio to text
smsSend SMS or WhatsApp messages
documentsExtract structured data from URLs
companiesLook up company data by domain
email-verifyCheck if an email is deliverable
transcribeTranscribe audio with speaker labels
invoice-parseExtract data from invoices
subtitleGenerate SRT/VTT subtitles
file-convertConvert files between 200+ formats
bg-removeRemove image backgrounds
screenshotCapture webpage screenshots

Response Format

Every tool returns a unified response object:

json
{
  "success": true,
  "data": {
    "results": [
      { "title": "OpenAI raises $6.6B", "url": "https://...", "snippet": "..." }
    ]
  },
  "error": null,
  "metadata": {
    "provider_used": "serperdev",
    "providers_tried": ["serperdev"],
    "response_time_ms": 1200,
    "request_id": "req_abc123"
  },
  "credits_used": 1
}

On failure, `success` is `false` and `error` contains the details (see below).

Error Handling

Error object structure (returned when `success` is `false`):

json
{
  "type": "billing_error",
  "title": "Insufficient credits",
  "status": 402,
  "detail": "Your account has 0 credits remaining. Add credits at suprsonic.ai/app/billing.",
  "is_retriable": false,
  "retry_after_seconds": null,
  "error_category": "billing"
}

Error categories: `transient` (retry safe), `permanent` (bad request), `authentication` (invalid key), `billing` (out of credits).

When using MCP, the AI agent receives the error in the tool response and can decide whether to retry based on `is_retriable` and `retry_after_seconds`.

Full API reference with all parameters and example responses: suprsonic.ai/apis

Frequently asked questions

What is suprsonic-mcp?

suprsonic-mcp is Suprsonic MCP server. One API key, 17 capabilities for your AI agent. Works with Claude Desktop, Cursor, VS Code, ChatGPT.

How do I install suprsonic-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is suprsonic-mcp open source?

Yes — it is hosted on GitHub at https://github.com/O-mega-Enterprise/suprsonic-mcp.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP