io.github.toosoontospoon/crate-quote
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.toosoontospoon/crate-quote What's it cost for a 48x30x36 crate to Chicago? Email me at jo@acme.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-services
MCP (Model Context Protocol) tools for several business services, one module per service. Each module is a thin client of that business's own HTTP API: no business logic lives here. The first service is crate, Speed Crate quotes for custom wooden shipping crates.
One server per service, so each can be listed on its own (MCP Registry, Muse Connector Platform), or all services in one server.
Transports: stdio (local clients such as Claude Desktop or Cursor) and streamable HTTP (hosted endpoints).
Official Python MCP SDK 2.x (
MCPServer, which replaced FastMCP),httpxfor the backend APIs.MIT licensed.
Quick start
pip install toosoon-mcp-services # not on PyPI yet: pip install -e ".[test]" from a checkout
export SPEEDCRATE_API_URL=http://127.0.0.1:8080 # the crate API (CustomCrateBuilder speedcrate-api)
toosoon-mcp-services --list # services and their tools
mcp-crate-quote # crate service only, stdio
toosoon-mcp-services --service crate # same
toosoon-mcp-services # every enabled service in one server
toosoon-mcp-services --service crate --transport streamable-http --host 127.0.0.1 --port 8765
# -> http://127.0.0.1:8765/mcp (--stateless for load balancers)Client config (stdio), e.g. Claude Desktop:
{ "mcpServers": { "crate-quote": {
"command": "uvx", "args": ["toosoon-mcp-services", "--service", "crate"],
"env": { "SPEEDCRATE_API_URL": "https://YOUR-CRATE-API" } } } }Related MCP server: SMKlog Parcel Shipping Rates
Configuration
Variable | Meaning |
| Comma list of services to run when |
| Base URL of the service's API (required to call its tools) |
| Optional API key, sent as |
| Request timeout in seconds (default 20) |
|
|
Prefixes: crate = SPEEDCRATE.
Services
crate: Speed Crate quotes (SPEEDCRATE_*)
Calls the CustomCrateBuilder HTTP API (speedcrate-api). Sizes are inside inches. Quotes need the
customer's email. They return only a price range (plus code, sizes, layout and notices) and say the
full quote will be emailed to that address. The API queues the full-quote request; this server sends
no email.
Tool | API call | Access | Sensitive data | Side effects |
|
| write | customer email (PII) | queues a full-quote request; the shop emails the customer |
|
| write | customer email (PII) | same |
|
| read-only | none | none |
|
| read-only | none | none |
|
| read-only | none | none |
|
| read-only | none | none |
The tools carry matching MCP annotations: readOnlyHint is true for the read tools. The quote tools
are readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true.
MCP Registry entries (one per service)
Each service gets its own registry entry and server.json under servers/<registry-name>/. All
entries point at the same PyPI package (toosoon-mcp-services) with a --service <name> package
argument, plus that service's environment variables. The registry checks PyPI ownership by looking for
an mcp-name line with the registry name in the package README (this file). Every service's name
gets its own line at the top of this file.
Service | Registry name | server.json |
crate |
|
|
Publishing (not done yet):
Release the package to PyPI.
mcp-publisher login githubas toosoontospoon.mcp-publisher publish servers/crate-quote/server.json.
mcp-publisher validate servers/crate-quote/server.json passes today.
Hosted endpoint (TODO): no public streamable-HTTP URL exists yet. When there is one, add a
remotes entry ({"type": "streamable-http", "url": "https://<host>/mcp"}) to the service's
server.json. A public deployment also needs TLS in front of it, an allowed Host/Origin list (the SDK's
DNS-rebinding protection), and probably --stateless.
Development
uv venv && uv pip install -e ".[test]"
pytest # unit tests with a mocked API (respx)
CRATE_API_REPO=/path/to/CustomCrateBuilder CRATE_API_PYTHON=/path/to/its/python pytest
# + integration tests against a local uvicorn of the API
SPEEDCRATE_TEST_API_URL=http://127.0.0.1:8080 pytest # or against a running APISee CONTRIBUTING.md to add a service.
Available Tools
6 toolscrate_preview_svgCrate preview drawing (SVG)BRead-onlyIdempotent
Isometric customer preview drawing of a crate, as SVG markup.
Inputs: code (required), dims. Returns: result
crate_size_limitsCrate size limitsBRead-onlyIdempotent
Minimum inside size and the standard/tall layout maximums (bigger sizes are oversized: custom quote).
Inputs: heavy_floor, forklift_base. Returns: object
encode_crate_codeEncode a crate codeCRead-onlyIdempotent
Configuration code for inside sizes and options (snapped to 1/16 inch, not raised to the minimum).
Inputs: h (required), l (required), w (required), lid, +4 more. Returns: object
parse_crate_codeParse a crate codeBRead-onlyIdempotent
Decode a crate configuration code into sizes and options and return its canonical form.
Inputs: code (required). Returns: object
quote_crateQuote a crateA
Quote a crate from inside width, height and length (inches) for a customer email. Returns the price range, configuration code, inside/outside size, layout and notices, plus a message that the full quote will be emailed to that address. Submits a full-quote request (not read-only).
Inputs: h (required), l (required), w (required), email (required), +5 more. Returns: object
quote_crate_by_codeQuote a crate by codeB
Same as quote_crate, for a configuration code such as SC-W19-H21.5-L30.75-BN-Q2.
Inputs: code (required), email (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
quote_crate and quote_crate_by_code have overlapping purpose but are clearly distinguished by input type (dimensions vs configuration code), and the description explicitly cross-references them. parse_crate_code and encode_crate_code are inverse operations with distinct roles, and crate_size_limits and crate_preview_svg are unambiguous. Only the two quote tools risk mild confusion.
Most tools use a verb_noun pattern (quote_crate, parse_crate_code, encode_crate_code) with a shared 'crate' token, giving good predictability. crate_size_limits and crate_preview_svg deviate to noun-first phrasing, a minor inconsistency but still readable and clearly scoped.
Six tools is well-scoped for a crate-quoting domain: two quoting paths, code parse/encode, size limits, and a preview generator. Each tool earns its place with no redundant or filler entries.
The surface covers the core lifecycle: quote from dimensions or code, encode/decode codes, check size limits, and render a preview. There is no tool to retrieve or manage previously submitted quote requests, but quoting plus code handling covers the main workflows an agent would need.
Maintenance
Related MCP Connectors
Live USPS, UPS & FedEx shipping rates plus USPS postage and stamp prices. Free, no API key.
Make price offers on Shopify products; get counters, single-use codes and checkout links.
Live USPS, UPS, FedEx and DHL rates from the US: domestic, Canada, UK, Germany, Australia. No scale.
Quote, book, and track LTL, FTL, cargo van, and box-truck freight via the Warp API.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceEnables AI agents to search a Shopify packaging-supplies catalog, get live pricing and inventory, recommend boxes, estimate shipping, and generate checkout URLs.1MIT- AlicenseAqualityBmaintenanceLive USPS, UPS, FedEx and DHL Express parcel rates from a US origin, domestic or to Canada, the UK, Germany and Australia, from a plain-words item description: no scale, no account, no API key. Also creates checkout links, reports checkout status, tracks parcels bought on smklog.com and serves a monthly US parcel price index.101MIT
- AlicenseNot gradedqualityCmaintenanceEnables real-time China-to-USA freight quotes with all-in delivered-duty-paid pricing for small shipments, without requiring an API key or signup.MIT
- AlicenseNot gradedqualityAmaintenanceEnables interaction with WooCommerce stores through the WordPress REST API, providing tools for managing products, orders, customers, shipping, taxes, coupons, payment gateways, reports, and store settings. Also supports WordPress content operations such as creating and updating posts and post metadata.MIT