MCP Pack
by cadi27tech
README.md
# Be Callable by AI (MCP pack)
Being **mentioned** by an AI assistant gives a buyer a name to type somewhere else. Being **callable** gives them an answer: what you do, what it costs, how to reach you. This pack is a small MCP (Model Context Protocol) server that lets Claude, ChatGPT and any other MCP client read your business profile or freelance profile and estimate prices from your own price list.
Part of **Source Included**, by Adrian Capraru. Source available under FSL-1.1-MIT (see `LICENSE`): use it for your own business and for clients; do not resell it as a competing product. It becomes MIT two years after release.
Node 22, **zero npm dependencies**, about 300 lines. It reads one JSON file you write. It never calls another API and needs no keys.
## Runs in production
| | |
|---|---|
| Months live | 1 (pattern live in production on 3Descu MCP since Oct 2026, listed in the official MCP registry as `io.github.cadi27tech/3descu-quote`) |
| Monthly running cost | EUR 0 locally over stdio; EUR 5-10/mo on a small Node VPS or serverless host |
| Version | 1.0.0 (this template is a clean rebuild; it contains no 3Descu pricing code) |
| Last tested | 20 Nov 2026 (`npm test`: 10 checks green, including real HTTP and stdio round trips) |
| Incidents | None since release (Oct 2026). Stateless JSON-RPC with per-IP rate limits. |
## Quick start (under 5 minutes)
```
node src/server.mjs --stdio # serves examples/business.example.json over stdio
npm test # 10 checks, no network
```
Make it yours: copy `examples/business.example.json` to `business.json` (or `examples/freelancer.example.json` for an "MCP about you" profile) and edit it. The server picks up `business.json` automatically.
### Connect it to Claude Code
```
claude mcp add my-business -- node /full/path/to/mcp-pack/src/server.mjs --stdio
```
### Connect it to Claude Desktop
Add to `claude_desktop_config.json`:
```json
{ "mcpServers": { "my-business": { "command": "node", "args": ["/full/path/to/mcp-pack/src/server.mjs", "--stdio"] } } }
```
### Run it as a public HTTP endpoint
```
node src/server.mjs # POST JSON-RPC to http://127.0.0.1:4700/mcp
```
Put it behind a reverse proxy with TLS (Caddy, Nginx, a platform like Fly.io or Render), set `TRUST_PROXY=1`, and register the HTTPS URL with MCP directories and the official MCP registry.
## Tools
| Tool | What it returns |
|---|---|
| `get_business_profile` | Name, description, location, who you serve, languages, hours, your AI policy, and the person profile if present |
| `list_offerings` | Every offering with id, unit, "from" price, limits, options and lead time |
| `estimate_price` | One figure for a quantity (base + per unit + options, volume discounts, minimum order value), or a range when no quantity is given; "on request" when an offering has no price |
| `how_to_contact` | Email, form or booking link, hours and reply time |
All tools are read-only (`readOnlyHint: true`). Bad input (unknown id, quantity under the minimum, unknown option) comes back as a tool error the assistant can read and correct, never as a crash.
## Business file
| Field | Notes |
|---|---|
| `currency`, `tax_note`, `quote_validity_days` | Shown with every estimate |
| `business.name`, `business.description` | Required |
| `business.contact` | Only what you want public. Use a role address, not a personal one |
| `profile` | Optional person block for the "MCP about you" use (headline, skills, proof, availability) |
| `offerings[]` | `id` (lowercase, hyphens), `name`, `unit`, `base_price`, `unit_price`, `min_qty`, `max_qty`, `typical_qty`, `lead_time_days`, `min_order_value`, `discounts[{from_qty, percent}]`, `options[{id, name, flat or per_unit}]`. Leave both prices out for "on request" |
The server refuses to start and lists every problem when the file is invalid.
## Configuration
| Variable | Default | What it does |
|---|---|---|
| `BUSINESS_FILE` | `./business.json`, else the example | Which file to serve |
| `PORT` / `HOST` | `4700` / `127.0.0.1` | HTTP listener |
| `ALLOWED_ORIGINS` | empty | Browser origins allowed to call `/mcp` (DNS rebinding guard from the MCP spec) |
| `RATE_PER_MINUTE` | 60 | Requests per IP per minute (memory only) |
| `TRUST_PROXY` | off | `1` behind a proxy |
## Protocol notes
Streamable HTTP without a server event stream: every call is one POST and one JSON reply, notifications get `202`, `GET /mcp` returns `405`. Protocol versions 2025-11-25, 2025-06-18, 2025-03-26 and 2024-11-05 are accepted; anything else is answered with the newest. No sessions are stored.
## Troubleshooting
| Symptom | Fix |
|---|---|
| Claude does not show the tools | Use the full absolute path in the config and restart the client. Run `node src/server.mjs --stdio` by hand: it should print one line to stderr and wait. |
| "business file is invalid" | Read the list it prints; each line names the field to fix. |
| `429` from the HTTP endpoint | The per-IP limit was hit. Raise `RATE_PER_MINUTE` if the traffic is real. |
| `403 Origin not allowed` | Add the calling site to `ALLOWED_ORIGINS`, or leave it empty. |
## Known limits
- Prices are a linear model (base + per unit + options + volume tiers). Anything more complex should stay "on request".
- Rate limits are per process, in memory.
- It answers questions; it does not take orders or payments.
## Full guide
`GUIDE.md` and the Source Included Vault cover writing a good business file, testing it inside Claude and listing the endpoint.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues