salesbuildr-mcp
OfficialThis server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
SalesBuildr MCP Server
A Model Context Protocol (MCP) server for integrating with the SalesBuildr quoting and sales platform. Built with a decision-tree architecture to expose domain-specific tools without overwhelming the LLM.
Architecture
The server uses a decision tree pattern:
At root, only
salesbuildr_navigateis exposedUser selects a domain (companies, contacts, products, opportunities, quotes)
Domain-specific tools become available along with
salesbuildr_backTool calls route to domain handlers that interact with the SalesBuildr API
Interactive Quote Card (MCP Apps)
salesbuildr_quotes_get renders as an interactive, read-only quote card in
MCP Apps hosts (Claude Desktop/web) — title, status, company/contact, dates,
line items, and totals; plain-JSON behavior is unchanged in other hosts.
The card is neutral by default and brandable via window.__BRAND__ injection
or MCP_BRAND_* env vars (MCP_BRAND_NAME, MCP_BRAND_LOGO_URL,
MCP_BRAND_PRIMARY_COLOR, MCP_BRAND_ACCENT_COLOR, MCP_BRAND_BG,
MCP_BRAND_TEXT) — no rebuild needed.
Related MCP server: connectwise-sell-mcp
Domains
Domain | Tools | Description |
companies | 5 | Company/account management (list, get, create, update, delete) |
contacts | 5 | Contact management (list, get, create, update, delete) |
products | 2 | Product catalog (list, get) |
opportunities | 4 | Sales pipeline (list, get, create, update) |
quotes | 3 | Quote management with line items (list, get, create) |
One-Click Deployment
Before you click: this server depends on @wyre-technology/node-salesbuildr,
which is hosted on the GitHub Packages npm registry. GitHub Packages has no
anonymous access — even though the package is public, every npm install needs a
token. The cloud builder runs npm install for you, so you must give it one, or
the build fails with npm error 401 Unauthorized ... npm.pkg.github.com.
Create a GitHub Personal Access Token with the
read:packagesscope (classic token). Any GitHub account works — you do not need to be a member of thewyre-technologyorg to read its public packages.Add it as a build variable when prompted by the deploy flow:
Cloudflare Workers → set a build variable named
NODE_AUTH_TOKENto your PAT (Workers → Settings → Build → Variables and Secrets).DigitalOcean App Platform → set an encrypted env var named
GITHUB_TOKENwith scope Build Time to your PAT (the Dockerfile reads it for the install).
Installation
This package is published to the GitHub Packages npm registry, which requires a token even for public packages. Authenticate once, then install:
# Authenticate npm to GitHub Packages (token needs the read:packages scope)
export NODE_AUTH_TOKEN=$(gh auth token) # or a PAT with read:packages
npm install @wyre-ai/salesbuildr-mcpThe repo's .npmrc already points the @wyre-technology scope at GitHub Packages and
reads the token from NODE_AUTH_TOKEN, so no further config is needed.
Configuration
Copy .env.example. Stdio and AUTH_MODE=env read the SalesBuildr variables. Gateway mode does not.
Environment Variables
Variable | Required | Default | Description |
| For stdio and | - | SalesBuildr API key |
| No | Library default | Tenant-specific base URL (e.g. |
| No |
|
|
| No |
| HTTP server port |
| No |
| Bind address when |
| No |
|
|
| Yes for HTTP | - | Service-to-service secret. The HTTP server logs an error and exits non-zero when this is empty or a known placeholder. Compose will not start without it. Never commit a real value. Generate one with |
| No | unset | Set to |
/health and /healthz stay unauthenticated and do not read credentials. The stdio transport does not use CONDUIT_S2S_SECRET.
HTTP authentication
With MCP_TRANSPORT=http and CONDUIT_S2S_SECRET set, every /mcp request must include X-Gateway-S2S. The value is t=<unix seconds>,v1=<hex>, where v1 is HMAC-SHA256 of the exact string t=<unix seconds> keyed by CONDUIT_S2S_SECRET (64 lowercase hex characters). The timestamp must be within 300 seconds of the server clock. A missing or invalid header returns 401. The secret is never written to logs.
import { createHmac } from "node:crypto";
const t = Math.floor(Date.now() / 1000);
const v1 = createHmac("sha256", process.env.CONDUIT_S2S_SECRET)
.update(`t=${t}`)
.digest("hex");
const xGatewayS2s = `t=${t},v1=${v1}`;In AUTH_MODE=gateway, /mcp also requires X-SalesBuildr-API-Key. That header is the only API-key source for the request. A request missing it returns 401 and does not read SALESBUILDR_API_KEY from the environment. After S2S verification, an optional X-SalesBuildr-Base-URL may supply the tenant API base (acme, https://acme.salesbuildr.com, https://acme.eu1-salesbuildr.com, or the same with /public-api). The host must be *.salesbuildr.com or *.eu1-salesbuildr.com; a bad value returns 400 and does not fall back to portal. Omitting the header leaves the client on the library default (https://portal.salesbuildr.com/public-api). Gateway mode never reads SALESBUILDR_BASE_URL from the environment.
Stdio Mode (Claude Desktop)
Add to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"salesbuildr": {
"command": "npx",
"args": ["@wyre-ai/salesbuildr-mcp"],
"env": {
"SALESBUILDR_API_KEY": "your-api-key"
}
}
}
}HTTP Mode (Gateway)
CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" MCP_TRANSPORT=http AUTH_MODE=gateway node dist/index.jsIn gateway mode, pass credentials via request headers. The gateway also signs each request with X-Gateway-S2S (see HTTP authentication):
X-Gateway-S2S: t=<unix seconds>,v1=<hex hmac-sha256>
X-SalesBuildr-API-Key: your-api-key
X-SalesBuildr-Base-URL: https://your-tenant.salesbuildr.comDocker
The image listens on 0.0.0.0 inside the container (MCP_HTTP_HOST) and defaults to AUTH_MODE=gateway. Publish the port on loopback and pass a real S2S secret. In gateway mode, the SalesBuildr API key arrives on each request as X-SalesBuildr-API-Key; it is not read from the environment.
docker run -d \
-e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
-p 127.0.0.1:8080:8080 \
ghcr.io/wyre-ai/salesbuildr-mcp:latestCompose refuses to start when CONDUIT_S2S_SECRET is unset, sets AUTH_MODE=gateway, does not set SALESBUILDR_API_KEY or env_file, and publishes 127.0.0.1:8080:8080:
CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" docker compose upSingle-tenant HTTP (AUTH_MODE=env) still requires the S2S secret, then uses SALESBUILDR_API_KEY:
docker run -d \
-e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
-e AUTH_MODE=env \
-e SALESBUILDR_API_KEY=your-api-key \
-p 127.0.0.1:8080:8080 \
ghcr.io/wyre-ai/salesbuildr-mcp:latestLocal HTTP without a secret is development-only. It binds 127.0.0.1 and logs a warning. A non-loopback MCP_HTTP_HOST makes startup exit:
MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm startDevelopment
# Install dependencies
npm install
# Run tests
npm test
# Type check
npm run typecheck
# Build
npm run build
# Run locally (stdio)
SALESBUILDR_API_KEY=your-key npm start
# Run locally (HTTP). Refuses to start until CONDUIT_S2S_SECRET is a real secret.
CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" MCP_TRANSPORT=http SALESBUILDR_API_KEY=your-key npm start
# Local HTTP only, without a service-to-service secret (always binds 127.0.0.1)
MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm startLicense
Apache-2.0
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for MarketTime — wholesale orders, customers, catalog and shipment tracking.
MCP server for the BuyerSense API. Get buyer signals from any MCP client.
MCP server for Flex on the Job: inventory, jobs, customers, invoices, purchasing, sales orders.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceThis MCP server provides tools to interact with the Salesforce Agentforce API, allowing authentication, session creation, and message exchange with Salesforce agents.10-
- AlicenseNot gradedqualityDmaintenanceMCP server wrapping the ConnectWise Sell REST API, providing tools to manage quotes, line items, tabs, customers, terms, templates, recurring revenue, and tax codes.1MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that provides tools for automating AWS Pricing Calculator estimate generation.MIT
- AlicenseNot gradedqualityBmaintenanceA focused MCP server for Salesforce CRM that exposes read/write access to standard CRM objects via six tools, designed for multi-tenant gateway deployments.Apache 2.0