@qubiton/mcp-server

MCP (Model Context Protocol) server for the QubitOn API by QubitOn. Provides Claude Desktop with access to 89 tools, 27 prompts, and 13 resources via stdio.

Quick Start

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "qubiton": {
      "command": "npx",
      "args": ["-y", "@qubiton/mcp-server"],
      "env": {
        "QUBITON_API_KEY": "svm..."
      }
    }
  }
}

Then restart Claude Desktop. The tools, prompts, and resources will appear automatically.

Client Configurations

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "qubiton": {
      "command": "npx",
      "args": ["-y", "@qubiton/mcp-server"],
      "env": {
        "QUBITON_API_KEY": "svm..."
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your project root:

{
  "mcp": {
    "servers": {
      "qubiton": {
        "command": "npx",
        "args": ["-y", "@qubiton/mcp-server"],
        "env": {
          "QUBITON_API_KEY": "svm..."
        }
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "qubiton": {
      "command": "npx",
      "args": ["-y", "@qubiton/mcp-server"],
      "env": {
        "QUBITON_API_KEY": "svm..."
      }
    }
  }
}

Cline

Add to VS Code settings under cline.mcpServers:

{
  "mcpServers": {
    "qubiton": {
      "command": "npx",
      "args": ["-y", "@qubiton/mcp-server"],
      "env": {
        "QUBITON_API_KEY": "svm..."
      }
    }
  }
}

How It Works

This package is a lightweight stdio-to-HTTP bridge. It connects to the QubitOn MCP server at https://mcp.qubiton.com/mcp, discovers available tools, prompts, and resources, and re-exposes them locally via stdio for Claude Desktop.

Authentication

Two authentication methods are supported:

API Key (recommended)

Set the QUBITON_API_KEY environment variable with your API key (starts with svm). The key is sent via the apikey header on every request.

OAuth2 Bearer Token

If you have an OAuth2 token from POST /api/oauth/token (client_credentials grant), set QUBITON_TOKEN. The token is sent via the Authorization: Bearer header. Both can be set simultaneously — the API key is always required, and the Bearer token provides additional identity context.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | QUBITON_API_KEY | Yes | — | Your API key (starts with svm) | | QUBITON_TOKEN | No | — | OAuth2 Bearer token for additional auth | | QUBITON_BASE_URL | No | https://mcp.qubiton.com | Override the MCP server base URL |

Available Tools (89)

The server exposes all tools from the QubitOn API across 9 categories:

• Core Validation — Address, tax ID, bank account, email, phone, business registration
• Compliance — Sanctions (OFAC/EU/UN), PEP screening, disqualified directors, EPA prosecution, healthcare exclusion
• Risk & Financial — Bankruptcy risk, credit score, fail rate, entity risk, credit analysis
• ESG & Cybersecurity — ESG scores, domain security, IP quality
• Corporate Structure — Beneficial ownership, corporate hierarchy, DUNS number, parent-child hierarchy
• Industry Specific — NPI, Medpass, DOT carrier, India identity, certifications, business classification
• Financial Operations — Payment terms analysis, currency exchange rates
• Ariba — Supplier profile lookup, supplier profile validation
• Other — Gender identification

Available Prompts (27)

Pre-built prompt templates for common business workflows:

• Onboarding (5) — New third-party onboarding, quick identity check, international entity verification, India entity verification, master data cleansing
• Compliance (5) — Sanctions screening, anti-corruption check, healthcare compliance, director due diligence, supplier diversity check
• Risk (5) — Comprehensive due diligence, financial stability assessment, ESG assessment, cybersecurity assessment, corporate structure analysis
• Payment (5) — Bank fraud prevention, pre-payment verification, payment optimization, periodic revalidation, transportation carrier check
• Subscriber Portal (7) — Account health check, usage investigation, error diagnosis, key security audit, webhook health check, plan optimization, team access review

Available Resources (13)

Reference datasets accessible to AI models:

• tool_inventory — Complete tool catalog organized by category
• entity_risk_categories — Risk category definitions
• healthcare_types — HCO/HCP entity types
• india_identity_types — PAN, Aadhaar, GSTIN, TAN, CIN formats
• certification_types — Diversity and small business certifications
• supported_countries — Country coverage by validation type
• about — API and company overview
• my_subscription — Current subscription details
• my_api_keys — API keys with status and IP restrictions
• my_usage_summary — Usage summary with quota and projections
• available_plans — Subscription plans with pricing
• my_webhooks — Configured webhooks and delivery status
• my_alerts — Alert rules for usage thresholds

MCP Protocol Support

This server implements the full Model Context Protocol specification, exposing the QubitOn API as 89 tools, 27 prompts, and 13 resources via stdio and streamable HTTP.

Summary

| Category | Count | Description | |----------|-------|-------------| | MCP Tools | 89 | 40 API validation + 49 portal management — same auth, rate limits, and plan access | | MCP Prompts | 27 | Multi-tool workflow templates across 5 categories (onboarding, compliance, risk, payment, subscriber portal) | | MCP Resources | 13 | Reference datasets (7) + subscriber portal resources (6) |

Prompts may be plan-gated. See Pricing for details.

Discovery Endpoints

• MCP Manifest -- machine-readable server metadata
• Resource Content -- fetch any resource by name

Accessing Resource Content

Resources are also available over plain HTTP for non-MCP clients:

curl https://mcp.qubiton.com/api/portal/mcp/resources/tool_inventory
curl https://mcp.qubiton.com/api/portal/mcp/resources/supported_countries

Available resources: tool_inventory, entity_risk_categories, healthcare_types, india_identity_types, certification_types, supported_countries, about.

Getting an API Key

1. Sign up for a free account at www.qubiton.com
2. Navigate to Dashboard > API Keys
3. Copy your API key

Development

npm install
npm run build

License

MIT