O-mega-Enterprise/suprsonic-mcp

MCP server for Suprsonic. Gives any AI agent dozens of capabilities through one connection.
## Quick Start
Connect to the hosted server, nothing to install:
URL: https://suprsonic.ai/v1/mcp (Streamable HTTP)
Header: Authorization: Bearer omkyourkey (or x-api-key: omkyourkey, for a client or gateway that keeps Authorization for its own sign-in)
Or run the server on your own machine:
bash
SUPRSONICAPIKEY=omkyourkey npx -y suprsonic-mcp
Get your API key at suprsonic.ai/app/api. Both offer the same tools at the same prices. Listing the tools needs no key; a call without a valid key answers with the API's own error, which says where to get one.
The package is suprsonic-mcp. Earlier copies of this README named @suprsonic/mcp: that npm scope belongs to an unrelated company, so never install it.
## Hosted server
### Claude Code
bash
claude mcp add --transport http suprsonic https://suprsonic.ai/v1/mcp --header "Authorization: Bearer omkyourkey"
### Cursor
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
json
"mcpServers": {
"suprsonic": {
"url": "https://suprsonic.ai/v1/mcp",
"headers": {
"Authorization": "Bearer omkyourkey"
### VS Code
Add to .vscode/mcp.json (VS Code asks for the key once and stores it as a secret):
json
"inputs": [
{ "type": "promptString", "id": "suprsonic-key", "description": "Suprsonic API key (omk...)", "password": true }
],
"servers": {
"suprsonic": {
"type": "http",
"url": "https://suprsonic.ai/v1/mcp",
"headers": {
"Authorization": "Bearer ${input:suprsonic-key}"
### Claude API (MCP connector)
Send the beta header anthropic-beta: mcp-client-2025-11-20 and add to your Messages request:
json
"mcpservers": [
{ "type": "url", "url": "https://suprsonic.ai/v1/mcp", "name": "suprsonic", "authorizationtoken": "omkyourkey" }
],
"tools": [
{ "type": "mcptoolset", "mcpservername": "suprsonic" }
### OpenAI Responses API
Add to the request's tools:
json
"type": "mcp",
"serverlabel": "suprsonic",
"serverurl": "https://suprsonic.ai/v1/mcp",
"authorization": "omkyourkey",
"requireapproval": "never"
### Smithery
Suprsonic is listed on Smithery as suprsonic. Add it to your Smithery toolbox and paste your key when Smithery asks for it; Smithery passes it to the hosted server as x-api-key.
## Local server (npx)
### Claude Desktop
Add to ~/Library/Application Support/Claude/claudedesktopconfig.json:
json
"mcpServers": {
"suprsonic": {
"command": "npx",
"args": ["-y", "suprsonic-mcp"],
"env": {
"SUPRSONICAPIKEY": "omkyourkey"
The same entry works in Cursor's mcp.json.
### Your own HTTP endpoint
To serve the HTTP transport from your own machine instead of using the hosted server:
bash
SUPRSONICAPIKEY=omkyourkey npx -y suprsonic-mcp --http --port 3100
Then connect to http://localhost:3100/mcp.
## Available Tools
A call costs credits only when it succeeds. Where a range is shown, the mode you pick sets the price.
| Tool | What it does | Credits |
| search | Search the web with SERP, AI synthesis, or both | 1-3 |
| scrape | Extract content from any URL as Markdown or HTML | 1-5 |
| profiles | Find and enrich professional profiles | 3 |
| emails | Find professional email addresses | 2 |
| images | Generate images from text prompts | 3 |