Servidor MCP

massprint

com.themassprint/massprint
Comercio y retail Público y accesible MCP 2026-07-28

Qué hace este MCP

Uploads and validates PDFs, creates print orders for books and other products, and supports payment, cancellation, and delivery tracking in India.

apply_enterprise
Apply for an enterprise (invoiced) account — for platforms printing at volume behind their own checkout. Enterprise orders auto-confirm with no payment link, are priced at a platform discount off retail (default 25% below), and are settled monthly. Requires a valid India GSTIN for tax invoicing. This does NOT issue a key immediately: the application is reviewed and, once approved, an API key is emailed to contact_email. Use this only when a human has asked to set up a business/enterprise print account.
Esquema de entrada
{'type': 'object', 'required': ['company_name', 'contact_email', 'gstin'], 'properties': {'gstin': {'type': 'string', 'description': '15-character India GSTIN, e.g. 29ABCDE1234F1Z5. Required for GST invoicing.'}, 'notes': {'type': 'string', 'description': 'Anything else for the reviewer (optional).'}, 'company_name': {'type': 'string', 'description': 'Registered business name.'}, 'contact_email': {'type': 'string', 'description': 'Where the approved API key and invoices are sent.'}, 'expected_monthly_volume': {'type': 'integer', 'minimum': 0, 'description': 'Approximate books printed per month (optional).'}}, 'additionalProperties': False}
cancel_order
Cancel an order, stopping it before it is printed. With the order_token from create_order this works while the order is awaiting_payment. A platform that sends its own API key (Authorization: Bearer mp_live_...) can additionally cancel an order THAT KEY created while it is confirmed or printing — that is how you stop a press when your customer cancels on your side. shipped and delivered can never be canceled; that is a refund, contact support (see get_catalog). Canceling stops production but moves no money, and it releases the order's client_reference — replaying that reference afterwards creates a new order and prints it. If the order moved on before the cancel landed you get not_cancellable naming its new status, never a false "canceled".
Esquema de entrada
{'type': 'object', 'required': ['order_id'], 'properties': {'order_id': {'type': 'string'}, 'order_token': {'type': 'string', 'description': 'The token returned once by create_order. Optional if you send the API key that created the order instead.'}}, 'additionalProperties': False}
create_order
Create a print order for a validated upload. Validates everything BEFORE any payment link is minted. Returns { order, order_token } — the order object has order_id, status, amount, and payment_url (the Razorpay link, present while awaiting_payment). Give payment_url to the human to pay (UPI/cards/netbanking). SAVE order_token — it is shown only once and is required for get_order and cancel_order. The order confirms automatically after payment; unpaid orders expire after 72 hours.
Esquema de entrada
{'type': 'object', 'required': ['upload_id', 'format', 'email', 'address'], 'properties': {'email': {'type': 'string', 'description': 'Buyer email; receives the Razorpay payment notification.'}, 'copies': {'type': 'integer', 'default': 1, 'maximum': 20, 'minimum': 1}, 'format': {'enum': ['paperback', 'hardcover', 'sticker-a3', 'greeting-card-a5'], 'type': 'string', 'description': 'paperback/hardcover: bound storybook (20-60 page PDF). sticker-a3: single-sheet A3 portrait sticker / wall chart (exactly 1 page, 842×1191 pt). greeting-card-a5: folded A5 greeting card, one A4-landscape sheet printed duplex (exactly 2 pages, 859×612 pt incl. 3 mm bleed).'}, 'address': {'type': 'object', 'required': ['name', 'line1', 'city', 'state', 'pincode', 'phone'], 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string'}, 'line1': {'type': 'string'}, 'line2': {'type': 'string'}, 'phone': {'type': 'string', 'description': 'India mobile, 10 digits, optional +91 prefix'}, 'state': {'type': 'string'}, 'pincode': {'type': 'string', 'description': '6-digit India PIN code'}}, 'description': 'India shipping address (V1 ships within India only).', 'additionalProperties': False}, 'upload_id': {'type': 'string', 'description': 'upload_id of a PDF that passed validation.'}}, 'additionalProperties': False}
create_upload
Start a PDF upload. Returns {upload_id, put_url, expires_at, max_bytes}. HTTP PUT the raw PDF bytes to put_url (Content-Type: application/pdf, no auth needed — the URL is signed). The PUT response includes the validation report. Then pass upload_id to create_order. Keyless use is bounded per calling origin: 20 create_upload calls per hour, at most 5 unused uploads open at a time, and put_url expires in 2 hours — so PUT the bytes promptly and reuse an upload_id you already hold instead of creating extras. An API key (see apply_enterprise) lifts both limits.
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_catalog
List what can be printed: SKUs (storybook books, sticker-a3 wall charts, greeting-card-a5 folded cards), formats, supported trim sizes, page-count limits, prices (INR, shipping included), and shipping coverage (India only). Call this first to quote a price or check whether a PDF will be accepted.
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_order
Check an order: status (awaiting_payment → confirmed → printing → shipped → delivered), tracking number once shipped, and — while unpaid — the payment_url again (so you can always re-answer "how do I pay"). Requires the order_token from create_order, or the API key that created the order (Authorization: Bearer mp_live_...).
Esquema de entrada
{'type': 'object', 'required': ['order_id'], 'properties': {'order_id': {'type': 'string'}, 'order_token': {'type': 'string', 'description': 'The token returned once by create_order. Optional if you send the API key that created the order instead.'}}, 'additionalProperties': False}
validate_pdf
Get the print-validation report for an uploaded PDF before paying: page count, trim size, hard errors (blocking) and soft warnings (non-blocking). Every error includes a `resolution` explaining how to fix it. Free to call; use it to check printability before create_order.
Esquema de entrada
{'type': 'object', 'required': ['upload_id'], 'properties': {'upload_id': {'type': 'string', 'description': 'The upload_id returned by create_upload.'}}, 'additionalProperties': False}
Añadido
apply_enterprise
17 de September de 2026 a las 12:37
Añadido
cancel_order
17 de September de 2026 a las 12:37
Añadido
get_order
17 de September de 2026 a las 12:37
Añadido
create_order
17 de September de 2026 a las 12:37
Añadido
validate_pdf
17 de September de 2026 a las 12:37
Añadido
create_upload
17 de September de 2026 a las 12:37
Añadido
get_catalog
17 de September de 2026 a las 12:37