com.smartpress/mcp · v0.1.0 · ecommerce
Smartpress is healthy: it completed an MCP handshake in 889 ms and exposes 21 tools.
Configure, price, proof and add custom print products to a Smartpress cart. US printing, no login.
Endpoint: https://mcp.smartpress.com/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 21 |
| Latency | 889 ms |
| Last checked (UTC) | 2026-10-22T04:40:15.561Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-22T04:40:15.561Z | Healthy | 889 |
get_product_config | Retrieve the default product configuration for a given product ID. Returns the full ProductConfiguration response including: - **availableOptions**: All configurable options organized by category: - **pressSheets**: Nested hierarchy of press sheet options (type -> weight -> color). Each press she |
find_products | Find Smartpress products matching a name or description. Returns matching products with their id, name, and description (plus group, link, image and a relevance score). Only products that can be configured through this assistant are returned. If nothing fits, say so and point the customer to smartp |
get_product_templates | Get the downloadable print templates and design guides for a Smartpress product. Returns: - **summary**: a one-line description of what this product has — paraphrase this rather than counting the arrays yourself. - **designGuides**: instructional PDFs about how to set artwork up (bleed, folding). N |
create_config_session | Create a new product configuration session to begin iterative configuration. This starts a server-side session that tracks your selection changes with version history. **Workflow:** 1. Call this tool with a productId (or productConfigId to clone an existing config) and optional initial selections 2 |
update_config_session | Update a configuration session with new selections. Saves the updated selections and returns the full ProductConfiguration response. **IMPORTANT — selections structure:** The selections object must use nested objects that mirror the structure of the selections field in the response. Flat keys are s |
get_session_latest | Retrieve the latest state of a configuration session. Returns the full ProductConfiguration response with current selections, validation messages, and available options. Use this to check session state without making changes. |
create_file_session | Create a file session for uploading proof/artwork files. Returns a **fileSessionId** that is durably joined to your configuration session so add_to_cart can attach the files without you threading the ID. **Two workflows:** - **File-first** (no product chosen yet): call with no arguments. A placehol |
link_file_session | Durably join a file session to a configuration session (last-write-wins). Use this when files were uploaded in one context and the configuration was created in another, or to re-link a configuration to a different file session. After linking, add_to_cart needs only the configuration sessionId — the |
clone_file_session | Copy a file session — files, approved proofs, and completed check results — into a NEW file session, leaving the original and its configuration join untouched. Optionally link the CLONE to a configuration session in the same call. Use this instead of link_file_session whenever the source file sessi |
list_session_files | List the files currently attached to a file session, including each file's name, size, type, and sessionFileId. Use this to confirm an upload landed or to show the user what is attached. |
get_file_upload_url | Mint a short-lived presigned URL that a client (a browser, an app, or the user) can use to upload a file directly to storage, attached to a file session. Use this when the bytes are NOT on the machine running this server — e.g. the remote/hosted server, or a file the user has in a browser. (When th |
add_to_cart | Add the current session configuration to the cart. Calls the add-to-cart endpoint which translates the session's selections into the format required by the external cart service. On success, returns a **clientKey** (anonymous cart identifier) and a **cartLink** (shareable URL to view the cart). The |
mcp_health_check | Run a health check against the Smartpress backend by probing each read-only tool with safe minimal inputs. Reports pass/fail per tool with latency. Use after deploys to confirm the backend is reachable. Write tools (create/update/add_to_cart) are intentionally skipped. |
analyze_file | Analyze a file already uploaded to a file session and return its analysis: PDF metadata (page size/count), extracted text, image labels, color palette, quality scores, and an AI classification (productCategory, industry, designStyle, targetAudience, marketingIntent). The file is analyzed in place f |
get_file_analysis | Fetch the status/results of a file analysis started by analyze_file (use the uploadId it returned). Returns the full results object once status is "ready". |
get_file_session_analysis | Read the persisted structured analysis summary for a file session. Returns { analysis } where analysis is the AnalysisSummary written by analyze_file (page count, trim size, classification, color palette, and recommended file-derived selections), or null when the file session carries no stored analy |
recommend_products | Map a file analysis (from analyze_file) to Smartpress product candidates: productId, productName, a rationale citing the analysis evidence, a 0-1 confidence, and machine-readable matchSignals. Candidates are ordered by confidence (max 5). Pass the analysis object returned by analyze_file (or just t |
get_file_session_proofs | Read the proof AND file-check state for a file session. Returns a compact view: - isProofable: whether the session's product/config supports proofing. - isFileCheckAvailable: whether a file check can run. A file check is a preflight report only (no proof file) and is often available when proofing is |
create_proof | Generate (enqueue) a preflight proof for a file in a file session: the proof service checks the file against the product's print specs and produces a proof with any errors/warnings. Returns { proofId, sessionId } once enqueued. Proof generation takes tens of seconds — after calling this, poll get_f |
create_file_check | Run (enqueue) a file check for a file in a file session: the proof service preflights the file against the product's print specs and produces a report of errors/warnings. Unlike create_proof it makes NO proof file — the report is the whole result, and there is nothing to approve. Use it when the se |
set_proof_approval | Record the customer's decision on a proof: APPROVED (they sign off on the proof as shown), FURTHER_REVIEW (a Smartpress expert checks the file before printing), or DECLINED. An approved proof is what prints: when the order is placed, the approved proof file goes to production and the order item is m |