Peecho MCP by usefulapi is an MCP server published by io.usefulapi, hosted at peecho.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 10 tools, including peecho_list_categories, peecho_list_offerings, peecho_get_offering_countries, peecho_get_offering_spine, peecho_request_quote.
Read print products, quotes and orders; create orders, set print files and addresses in Peecho.
4,000 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List Peecho product categories and their sub-category codes (for example Books / HC). Use a sub-category code with peecho_list_offerings. Peecho API: GET /rest/v3/categories.
No parameters.
{
"name": "peecho_list_categories",
"title": "List product categories",
"description": "List Peecho product categories and their sub-category codes (for example Books / HC). Use a sub-category code with peecho_list_offerings. Peecho API: GET /rest/v3/categories.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List product categories",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
List the print products (offerings) available to this merchant, grouped by category code. Each offering has an id, name, paper type and minimum quantity. Peecho API: GET /rest/v3/offering/list.
| Parameter | Type | Description |
|---|---|---|
| subCategoryFilter | string | Sub-category code from peecho_list_categories, e.g. HC (hardcover books). |
{
"name": "peecho_list_offerings",
"title": "List offerings",
"description": "List the print products (offerings) available to this merchant, grouped by category code. Each offering has an id, name, paper type and minimum quantity. Peecho API: GET /rest/v3/offering/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"subCategoryFilter": {
"type": "string",
"description": "Sub-category code from peecho_list_categories, e.g. HC (hardcover books)."
}
}
},
"annotations": {
"title": "List offerings",
"readOnlyHint": true
}
}Return the countries each offering can ship to. Read-only. Peecho API: POST /rest/v3/offering/countries.
| Parameter | Type | Description |
|---|---|---|
| offering_ids * | array | Offering ids to check. |
{
"name": "peecho_get_offering_countries",
"title": "Get shipping countries for offerings",
"description": "Return the countries each offering can ship to. Read-only. Peecho API: POST /rest/v3/offering/countries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"offering_ids"
],
"properties": {
"offering_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Offering id (the id field from peecho_list_offerings).",
"exclusiveMinimum": 0
},
"maxItems": 50,
"minItems": 1,
"description": "Offering ids to check."
}
}
},
"annotations": {
"title": "Get shipping countries for offerings",
"readOnlyHint": true
}
}Calculate the spine width (in millimetres) an offering needs for a page count in a country. Read-only. Peecho API: GET /rest/v3/offering/spine.
| Parameter | Type | Description |
|---|---|---|
| offering_id * | integer | Offering id (the id field from peecho_list_offerings). |
| country_code * | string | ISO 3166-1 alpha-2 country code, e.g. NL. |
| number_of_pages * | integer | Number of pages in the print file. |
{
"name": "peecho_get_offering_spine",
"title": "Get spine width for an offering",
"description": "Calculate the spine width (in millimetres) an offering needs for a page count in a country. Read-only. Peecho API: GET /rest/v3/offering/spine.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"offering_id",
"country_code",
"number_of_pages"
],
"properties": {
"offering_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Offering id (the id field from peecho_list_offerings).",
"exclusiveMinimum": 0
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 country code, e.g. NL."
},
"number_of_pages": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of pages in the print file.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get spine width for an offering",
"readOnlyHint": true
}
}Return prices, currency and shipping for items sent to a destination. It does not create an order. Peecho API: POST /rest/v3/quote.
| Parameter | Type | Description |
|---|---|---|
| items * | array | |
| state | string | Destination state or region code, where needed. |
| currency | string | ISO 4217 currency, e.g. EUR. |
| country_code | string | Destination country code. |
{
"name": "peecho_request_quote",
"title": "Request a price quote",
"description": "Return prices, currency and shipping for items sent to a destination. It does not create an order. Peecho API: POST /rest/v3/quote.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"offering_id",
"number_of_pages",
"quantity"
],
"properties": {
"quantity": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"offering_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Offering id (the id field from peecho_list_offerings).",
"exclusiveMinimum": 0
},
"number_of_pages": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"maxItems": 50,
"minItems": 1
},
"state": {
"type": "string",
"description": "Destination state or region code, where needed."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 currency, e.g. EUR."
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Destination country code."
}
}
},
"annotations": {
"title": "Request a price quote",
"readOnlyHint": true
}
}Get an order's state (for example OPEN or PAID), price data, shipping address and items. Read-only. Peecho API: GET /rest/v3/order/details.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | The order id (from peecho_create_order or the Peecho dashboard). |
{
"name": "peecho_get_order",
"title": "Get an order",
"description": "Get an order's state (for example OPEN or PAID), price data, shipping address and items. Read-only. Peecho API: GET /rest/v3/order/details.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The order id (from peecho_create_order or the Peecho dashboard)."
}
}
},
"annotations": {
"title": "Get an order",
"readOnlyHint": true
}
}Return the spine width for each item in an order. Read-only. Peecho API: GET /rest/v3/order/spine/.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | The order id (from peecho_create_order or the Peecho dashboard). |
{
"name": "peecho_get_order_spine",
"title": "Get spine widths for an order",
"description": "Return the spine width for each item in an order. Read-only. Peecho API: GET /rest/v3/order/spine/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The order id (from peecho_create_order or the Peecho dashboard)."
}
}
},
"annotations": {
"title": "Get spine widths for an order",
"readOnlyHint": true
}
}WRITE: create an OPEN print order with one or more items. It does not pay for the order, and nothing is printed until it is paid in Peecho. Items need a unique item_reference. Peecho API: POST /rest/v3/order/.
| Parameter | Type | Description |
|---|---|---|
| currency * | string | ISO 4217 currency, e.g. EUR. |
| item_details * | array | |
| purchase_order | string | Your own purchase order reference. |
| address_details | object | Customer and shipping address. Set it later with peecho_update_order_address if omitted. |
{
"name": "peecho_create_order",
"title": "Create a print order",
"description": "WRITE: create an OPEN print order with one or more items. It does not pay for the order, and nothing is printed until it is paid in Peecho. Items need a unique item_reference. Peecho API: POST /rest/v3/order/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"currency",
"item_details"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 currency, e.g. EUR."
},
"item_details": {
"type": "array",
"items": {
"type": "object",
"required": [
"item_reference",
"offering_id",
"quantity"
],
"properties": {
"quantity": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"offering_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Offering id (the id field from peecho_list_offerings).",
"exclusiveMinimum": 0
},
"file_details": {
"type": "object",
"required": [
"content_url",
"number_of_pages"
],
"properties": {
"content_url": {
"type": "string",
"format": "uri",
"description": "Public URL of the print file (PDF)."
},
"content_width": {
"type": "number",
"description": "Print width in millimetres (the Peecho example uses 210).",
"exclusiveMinimum": 0
},
"content_height": {
"type": "number",
"description": "Print height in millimetres (the Peecho example uses 210).",
"exclusiveMinimum": 0
},
"number_of_pages": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"description": "The print file. Omit it and send the file later with peecho_set_order_files."
},
"item_reference": {
"type": "string",
"minLength": 1,
"description": "Your own reference for this item. It must be unique across Peecho orders."
}
}
},
"maxItems": 50,
"minItems": 1
},
"purchase_order": {
"type": "string",
"description": "Your own purchase order reference."
},
"address_details": {
"type": "object",
"required": [
"email_address",
"shipping_address"
],
"properties": {
"email_address": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"shipping_address": {
"type": "object",
"required": [
"first_name",
"last_name",
"address_line_1",
"zip_code",
"city",
"country_code"
],
"properties": {
"city": {
"type": "string",
"minLength": 1
},
"state": {
"type": "string",
"description": "State or region code, where the country uses one."
},
"zip_code": {
"type": "string",
"minLength": 1
},
"last_name": {
"type": "string",
"minLength": 1
},
"first_name": {
"type": "string",
"minLength": 1
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 country code, e.g. NL."
},
"address_line_1": {
"type": "string",
"minLength": 1
},
"address_line_2": {
"type": "string"
}
}
}
},
"description": "Customer and shipping address. Set it later with peecho_update_order_address if omitted."
}
}
},
"annotations": {
"title": "Create a print order",
"readOnlyHint": false,
"destructiveHint": true
}
}WRITE: replace the customer email and shipping address on an open order. Peecho API: POST /rest/v3/order/address.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | The order id (from peecho_create_order or the Peecho dashboard). |
| address_details * | object |
{
"name": "peecho_update_order_address",
"title": "Update an order's address",
"description": "WRITE: replace the customer email and shipping address on an open order. Peecho API: POST /rest/v3/order/address.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"address_details"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "The order id (from peecho_create_order or the Peecho dashboard)."
},
"address_details": {
"type": "object",
"required": [
"email_address",
"shipping_address"
],
"properties": {
"email_address": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"shipping_address": {
"type": "object",
"required": [
"first_name",
"last_name",
"address_line_1",
"zip_code",
"city",
"country_code"
],
"properties": {
"city": {
"type": "string",
"minLength": 1
},
"state": {
"type": "string",
"description": "State or region code, where the country uses one."
},
"zip_code": {
"type": "string",
"minLength": 1
},
"last_name": {
"type": "string",
"minLength": 1
},
"first_name": {
"type": "string",
"minLength": 1
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 country code, e.g. NL."
},
"address_line_1": {
"type": "string",
"minLength": 1
},
"address_line_2": {
"type": "string"
}
}
}
}
}
}
},
"annotations": {
"title": "Update an order's address",
"readOnlyHint": false,
"idempotentHint": true
}
}WRITE: send the print file URL for each item of an order. Each merchant_item_reference must match an item_reference of the order. Peecho API: POST /rest/v3/order/files.
| Parameter | Type | Description |
|---|---|---|
| files * | array |
{
"name": "peecho_set_order_files",
"title": "Set an order's print files",
"description": "WRITE: send the print file URL for each item of an order. Each merchant_item_reference must match an item_reference of the order. Peecho API: POST /rest/v3/order/files.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"files"
],
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"merchant_item_reference",
"source_file"
],
"properties": {
"source_file": {
"type": "string",
"format": "uri",
"description": "Public URL of the print file (PDF)."
},
"merchant_item_reference": {
"type": "string",
"minLength": 1,
"description": "The item_reference of the order item."
}
}
},
"maxItems": 50,
"minItems": 1
}
}
},
"annotations": {
"title": "Set an order's print files",
"readOnlyHint": false,
"idempotentHint": true
}
}Tools for Peecho, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which print products can I order in hardcover, and what does a 200-page book cost to ship to Germany?"; "Create a print order for 50 copies of this PDF and ship it to my warehouse."; "What is the status of order 50786?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Peecho data. Free plan: 50 tool calls per month. Run peecho_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run peecho_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run peecho_upgrade without a plan: it returns both plans, each with a payment link for the user to open. peecho_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.