Suprsonic Mcp

Name: Suprsonic Mcp
Author: O-mega-Enterprise

@O-mega-Enterprise

Repository

About Suprsonic Mcp

Suprsonic is a unified agent API that bundles dozens of capabilities behind one API key.

#mcp #ai-agent #unified-api #search #scrape #web-scraping #enrichment #tts #stt #tools

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

Search the web. Returns AI-synthesized answers, raw SERP results, or both. Cost: serp 1 credit, ai 2 credits, deep 3 credits.

Extract content from any URL as Markdown. Auto-escalates from fast HTTP to JS rendering to stealth browser. Cost: fast 1 credit, standard 2 credits, thorough 5 credits.

Find and enrich a professional profile by LinkedIn URL or name + company. Cost: 3 credits.

Find a professional email address by name and company domain. Cost: 2 credits.

Generate an image from a text prompt. Cost: 3 credits.

Convert text to speech audio. Cost: 2 credits.

Transcribe audio to text with timestamps. Cost: 2 credits.

Send an SMS or WhatsApp message. Cost: 1 credit.

Extract structured data from a URL or text content using LLM analysis. Cost: 3 credits.

Look up company data by domain. Returns industry, size, description, logo, brand colors. Cost: 3 credits.

Check if an email address is deliverable. Cost: 1 credit.

Transcribe audio or video with speaker labels and timestamps. Cost: 3 credits.

Extract structured line items, totals, and dates from an invoice or receipt. Cost: 3 credits.

Generate SRT or VTT subtitles from audio or video. Cost: 2 credits.

Convert a file between 200+ formats (PDF, DOCX, XLSX, images, etc.). Cost: 2 credits.

Remove the background from an image. Cost: 2 credits.

Capture a rendered screenshot of a webpage. Cost: 1 credit.

Overview

What is Suprsonic MCP?

Suprsonic MCP is a Model Context Protocol server that connects any AI agent to dozens of ready-to-use capabilities through a single integration. It wraps the Suprsonic platform, providing tools for search, content extraction, communication, media generation, and more. Designed for developers building with Claude, ChatGPT, Cursor, VS Code, or any MCP-compatible client.

How to use Suprsonic MCP?

Run it instantly via npx -y @suprsonic/mcp with the SUPRSONIC_API_KEY environment variable set. For local use with Claude Desktop, add the command to claude_desktop_config.json; for Cursor/VS Code, add it to .cursor/mcp.json or the VS Code MCP config. A remote HTTP server is available with --http --port 3100, listening on http://localhost:3100/mcp.

Key features of Suprsonic MCP

Web search with AI synthesis, SERP, or both
URL scraping to Markdown
Professional profile and email finding
Image generation from text prompts
Text-to-speech and audio transcription
SMS and WhatsApp messaging
File conversion across 200+ formats
Invoice parsing and subtitle generation
Unified response object with metadata and credit usage
Structured error handling with retry information

Use cases of Suprsonic MCP

An AI assistant that searches the web and extracts article content for research.
A recruitment tool that finds professional profiles and verified emails.
A content pipeline that converts text to speech or transcribes meeting audio.
An automation that sends SMS or WhatsApp notifications via AI agents.
A document processing workflow that parses invoices and converts file formats.

FAQ from Suprsonic MCP

What is the response format?

Every tool returns a unified JSON object with success, data, error, metadata, and credits_used fields. On failure, success is false and an error object with type, title, status, and detail is returned.

How does error handling work?

Errors include a category (transient, permanent, authentication, billing) and an is_retriable flag. AI agents can decide to retry based on is_retriable and optional retry_after_seconds.

What tools are available?

Tools include: search, scrape, profiles, emails, images, tts, stt, sms, documents, companies, email-verify, transcribe (with speaker labels), invoice-parse, subtitle, file-convert, bg-remove, and screenshot. Full parameter details are at suprsonic.ai/apis.

Where do I get an API key?

Sign up at suprsonic.ai and generate an API key from suprsonic.ai/app/apis. The key must be set as the SUPRSONIC_API_KEY environment variable.

Can I run Suprsonic MCP as a remote server?

Yes. Use the --http --port 3100 flags, then connect any HTTP‑based MCP client to http://localhost:3100/mcp. This works with Claude API, ChatGPT, and programmatic agents.