Supernova MCP Connector

Supernova is a hosted MCP tool marketplace at supernova.cool. Publish REST APIs as paid MCP tools, discover and call them with metering, auth, and real-time analytics.

This package provides a Python stdio MCP connector that gives Claude Desktop, Cursor, and other MCP-compatible clients access to the Supernova tool registry.

Installation

pip install supernova-connector

MCP Configuration (Claude Desktop / Cursor)

Option 1: Hosted MCP URL (Recommended)

{
  "mcpServers": {
    "supernova": {
      "url": "https://supernova.cool/api/v1/mcp/",
      "headers": {
        "X-Supernova-Key": "YOUR_API_KEY"
      }
    }
  }
}

Option 2: stdio Connector

{
  "mcpServers": {
    "supernova": {
      "command": "supernova-connector",
      "env": {
        "SUPERNOVA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Python SDK Usage

from supernova_connector import SupernovaClient, Swarm

# Discover tools by intent
results = SupernovaClient.discover("fetch a URL and extract the title")
print(results)

# Execute a tool
result = SupernovaClient.execute(
    tool_id="core-001",
    payload={"query": "https://news.ycombinator.com"}
)
print(result)

# Get a Swarm WebSocket connection string
swarm = Swarm(agent_id="my-agent-id")
print("WebSocket URL:", swarm.get_connection_string())

Available Tools

The connector exposes three MCP tools:

Environment Variables

Pricing

• Free tier: 1,000 NOVA credits on signup (1 NOVA ≈ $0.001 USD)
• Tool calls cost 0.5–1.0 NOVA each
• Credit packs available from $10–$250 via Stripe

Documentation

• Supernova Docs
• API Reference
• Security

License

MIT — operated by Data Genius LLC