Suprsonic Mcp

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.