Sales MCP Server 🐳 Docker

Sherweb MCP

MCP server for Sherweb Partner API — distributor billing, service provider customers, subscriptions, and payable charges.

🔗 Companion Plugin

Pair this MCP server with the Sherweb plugin for skills, commands, and API knowledge alongside direct API access.

Installation

Run the MCP server with npx:

npx @wyre-technology/sherweb-mcp

Or install the package:

npm install @wyre-technology/sherweb-mcp

MCPB Bundle (Claude Desktop)

Download the .mcpb bundle from GitHub Releases for a zero-config Claude Desktop install. No Node.js or terminal required — just open the bundle in Claude Desktop via Settings → MCP Servers → Install from file. Requires Claude Desktop 0.10+.

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "sherweb": {
      "command": "npx",
      "args": [
        "@wyre-technology/sherweb-mcp"
      ],
      "env": {
        "SHERWEB_CLIENT_ID": "your-sherweb-client-id",
        "SHERWEB_CLIENT_SECRET": "your-sherweb-client-secret",
        "SHERWEB_SUBSCRIPTION_KEY": "your-sherweb-subscription-key"
      }
    }
  }
}

Authentication

Variable	Required	Description
`SHERWEB_CLIENT_ID`	Yes	Sherweb Partner API client ID
`SHERWEB_CLIENT_SECRET`	Yes	Sherweb Partner API client secret
`SHERWEB_SUBSCRIPTION_KEY`	Yes	Sherweb subscription key (per Partner API tenant)

Getting Credentials

⚠️ Portal verification pending

The instructions below are our best understanding of the vendor's credential-acquisition flow but have not been verified hands-on against the current portal. If you hit a step that doesn't match what you see, please let us know — we'll update the docs.

Vendor portal: https://www.sherweb.com/partners/

Prerequisites

Sherweb Partner account with Partner API access

Steps

Sign in to your Sherweb Partner portal.
Navigate to API access to generate Client ID + Client Secret pair.
Obtain a per-tenant Subscription Key for the Partner API tier.
Set SHERWEB_CLIENT_ID, SHERWEB_CLIENT_SECRET, and SHERWEB_SUBSCRIPTION_KEY.

Architecture

Single TypeScript MCP server with per-domain handlers, authenticating via Sherweb Partner API OAuth (client credentials + subscription key).

Available Tools (8)

Tools are organized into 4 domains:

Customers

Manage end-customer organizations under your Sherweb partner account.

Tool	Description
`sherweb_customers_list`	List end-customers
`sherweb_customers_get`	Get customer details

Subscriptions

Subscription inventory and lifecycle.

Tool	Description
`sherweb_subscriptions_list`	List subscriptions across customers
`sherweb_subscriptions_get`	Get a single subscription

Catalog

Available product catalog from Sherweb.

Tool	Description
`sherweb_catalog_list`	List catalog products
`sherweb_catalog_get`	Get product details

Billing

Payable charges and billing items.

Tool	Description
`sherweb_billing_payables_list`	List payable charges
`sherweb_billing_payables_get`	Get a single payable charge