NexusBridge MCP Server

A Model Context Protocol server that gives AI agents access to 200+ AI models and 10 service categories through a unified, metered API. One API key, one integration, transparent per-call pricing.

API Base: https://syntss.com
Smithery: smithery.ai/servers/guhank/nexusbridge-mcp-server
GitHub: github.com/guhank/nexusbridge-mcp-server

Tools

Tool	Description
nexusbridge_catalog	Retrieve the full service catalog with slugs, descriptions, per-call prices, and your current credit balance. Call this first to discover available services.
nexusbridge_execute	Execute any NexusBridge service by its slug. Pass service-specific parameters. Credits are deducted automatically. Returns the upstream provider's response.
nexusbridge_balance	Check your current credit balance (USD) and the number of active services available. Use before expensive operations to verify sufficient funds.

nexusbridge_catalog

Returns every available service with its slug, name, category, description, and per-call price in USD. Also returns your current credit balance.

Parameters: None

Example response:

{
  "services": [
    { "slug": "llm-chat", "name": "LLM Chat", "category": "ai", "pricePerCall": 0.005 },
    { "slug": "web-search", "name": "Web Search", "category": "search", "pricePerCall": 0.01 }
  ],
  "creditBalance": 24.50
}

nexusbridge_execute

Execute a service by passing its slug and service-specific parameters.

Parameters:

Parameter	Type	Required	Description
slug	string	Yes	Service slug from the catalog (e.g., llm-chat, web-search, sentiment)
params	object	No	Service-specific parameters (see examples below)

Examples:

// LLM Chat — use any of 200+ models
{ "slug": "llm-chat", "params": { "messages": [{"role": "user", "content": "Explain quantum computing"}], "model": "deepseek/deepseek-chat-v3-0324" } }

// Sentiment Analysis
{ "slug": "sentiment", "params": { "text": "I love this product! Best purchase I've ever made." } }

// Web Search
{ "slug": "web-search", "params": { "query": "latest AI news March 2026" } }

// Text Summarization
{ "slug": "summarize", "params": { "text": "Long article text here..." } }

// Translation
{ "slug": "translation", "params": { "text": "Hello world", "to": "es" } }

// Code Generation
{ "slug": "llm-code", "params": { "prompt": "Write a Python function to calculate fibonacci numbers" } }

// Image Generation
{ "slug": "image-gen", "params": { "prompt": "A serene mountain landscape at sunset" } }

// Text Embedding
{ "slug": "text-embedding", "params": { "text": "semantic search query" } }

Example response:

{
  "success": true,
  "service": "llm-chat",
  "charged": 0.005,
  "remainingBalance": 24.495,
  "result": {
    "choices": [{ "message": { "content": "Quantum computing uses..." } }]
  }
}

nexusbridge_balance

Returns your credit balance and the count of active services.

Parameters: None

Example response:

{
  "creditBalance": 24.50,
  "serviceCount": 10
}

Available Services

Service	Slug	Price/Call	Description
LLM Chat	llm-chat	$0.005	Chat completions with GPT-4o, Claude, Gemini, DeepSeek, Llama, and 200+ models via OpenRouter
Code Generation	llm-code	$0.008	Code generation, refactoring, and completion optimized for development tasks
Image Generation	image-gen	$0.05	Create images from text prompts using DALL-E, SDXL, and Flux models
Text Embedding	text-embedding	$0.001	Vector embeddings for RAG pipelines, semantic search, and clustering
Web Search	web-search	$0.01	Structured web search results with titles, URLs, and snippets
Document Parser	doc-parser	$0.02	Extract text and structured data from PDFs, images, and documents
Sentiment Analysis	sentiment	$0.003	Classify text sentiment (positive/negative/neutral) with confidence scores and emotion detection
Translation	translation	$0.005	Neural machine translation across 100+ languages
Summarization	summarize	$0.008	Configurable-length text summaries from long documents
Code Execution	code-exec	$0.015	Run code in sandboxed Python, Node.js, and Go environments

Installation

Smithery (Recommended)

Install directly from Smithery with one click. Configure your NexusBridge API key when prompted.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "nexusbridge": {
      "command": "npx",
      "args": ["-y", "nexusbridge-mcp-server", "--stdio"],
      "env": {
        "NEXUSBRIDGE_API_KEY": "nb_sk_your_key_here"
      }
    }
  }
}

Cursor / Windsurf / Other MCP Clients

Use the same configuration pattern — set NEXUSBRIDGE_API_KEY as an environment variable and run via npx -y nexusbridge-mcp-server --stdio.

Docker

docker build -t nexusbridge-mcp .
docker run -p 8000:8000 \
  -e NEXUSBRIDGE_API_KEY=nb_sk_your_key \
  nexusbridge-mcp

Manual

git clone https://github.com/guhank/nexusbridge-mcp-server.git
cd nexusbridge-mcp-server
npm install
NEXUSBRIDGE_API_KEY=nb_sk_your_key npm start

Usage

1. Get an API key — Purchase credits at syntss.com. Credits start at $10. You'll receive an nb_sk_... API key.

2. Install the MCP server — Use Smithery, Claude Desktop config, or run manually (see Installation above).

3. Discover services — Your AI agent calls nexusbridge_catalog to see all available services, pricing, and your credit balance.

4. Execute services — Call nexusbridge_execute with the service slug and parameters. Credits are deducted per call.

5. Monitor spending — Call nexusbridge_balance to check remaining credits at any time.

Typical Agent Workflow

Agent → nexusbridge_catalog           → "I see 10 services, balance is $24.50"
Agent → nexusbridge_execute(llm-chat) → "Got response from DeepSeek, charged $0.005"
Agent → nexusbridge_execute(sentiment)→ "Text is positive (0.94 confidence), charged $0.003"
Agent → nexusbridge_balance           → "Balance is $24.492"

Environment Variables

Variable	Required	Default	Description
NEXUSBRIDGE_API_KEY	Yes	—	Your NexusBridge API key (starts with nb_sk_)
NEXUSBRIDGE_BASE_URL	No	https://syntss.com	Base URL of the NexusBridge API
PORT	No	8000	HTTP port for Smithery/hosted mode

Transport Modes

Mode	Flag	Use Case
HTTP	(default)	Smithery hosted deployment, remote MCP clients
stdio	--stdio	Claude Desktop, Cursor, local MCP clients

Getting API Credits

Tier	Credits	Approx. LLM Calls
Starter	$10	~2,000
Builder	$25	~5,000
Pro	$50	~10,000
Scale	$100	~20,000

Purchase at syntss.com or via Stripe. Credits never expire.

License

MIT