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) |
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 |