73 herramientas MCP + REST API completa

Documentación de la API de TutuPrints

Usa la API REST o el protocolo MCP para que un asistente de IA realice directamente impresión de fotos, impresión de documentos, gestión de pedidos y todas las demás operaciones.
Compatible con 21 clientes de IA populares, incluidos Claude, Gemini, Codex y Copilot.

Inicio rápido

Intégralo en tres pasos y empieza a usar la IA para imprimir de inmediato.

Crear una cuenta

Visita el sitio de TutuPrints y regístrate rápido con un código de verificación por SMS.

Crear una API Key

En la página «Claves API» de tu centro de cuenta, crea una clave con un clic y úsala al instante.

Hacer una solicitud

Llama a la API REST con tu API Key, o configúrala en un cliente de IA para usar MCP.

Autenticación

Todas las solicitudes a la API se autentican con la API Key en un encabezado HTTP.

Authorization: Bearer tk_YOUR_API_KEY

Base URL

https://tutupp.com

Formato de respuesta

Content-Type: application/json

Endpoint MCP

POST https://tutupp.com/api/mcp

Plataforma abierta: tras registrarte, crea una API Key sin aprobación y usa todas las funciones de API y MCP de inmediato.

Integración MCP

MCP (Model Context Protocol) es un protocolo abierto de Anthropic que permite a los asistentes de IA llamar herramientas externas directamente.

Una vez configurado, puedes usar lenguaje natural para que la IA ejecute el flujo completo «subir documento → crear pedido → pagar con saldo».

Información del protocolo

Endpoint: https://tutupp.com/api/mcp

Protocolo: JSON-RPC 2.0 over Streamable HTTP

Métodos: initialize · tools/list · tools/call

Subida de archivos: Admite la extensión multipart/form-data (message part + file parts, sin base64, 100MB+) y el estándar application/json

Elige tu cliente de IA 21

Claude Code — mcs_desc_cli

Añadir (Add)

claude mcp add --transport http tutuprints https://tutupp.com/api/mcp --header "Authorization: Bearer tk_YOUR_API_KEY"

Añade --scope user para global, --scope project solo para el proyecto actual

Reemplazar clave (Replace)

claude mcp remove tutuprints && claude mcp add --transport http tutuprints ...(clave nueva)

Quitar (Remove)

claude mcp remove tutuprints

Ejemplo de conversación con IA

Tú: Imprime report.pdf de mi escritorio, A4 en blanco y negro, y paga con mi saldo

La IA llama automáticamente:

1. upload_document → Subir el archivo

2. get_print_prices → Consultar el precio de A4 B/N

3. create_order → Crear el pedido

4. pay_with_balance → Pagar con saldo

AI: ¡Listo! Pedido PP2026040612345, A4 B/N ×1, se dedujeron ¥0,50 de tu saldo.

Referencia de la API REST

Una API Key puede acceder a todos los endpoints siguientes, cubriendo todas las funciones de la interfaz.

adt0

POST /api/documents/upload add0

GET /api/documents add1

GET /api/documents/{id} add2

DELETE /api/documents/{id} add3

adt1

POST /api/photos/upload add4

GET /api/photos/{id} add5

DELETE /api/photos/{id} add6

GET /api/photos/{id}/quality-check?size={size} add7

adt2

POST /api/orders add8

GET /api/orders add9

GET /api/orders/{id} add10

PUT /api/orders/{id}/cancel add11

GET /api/orders/track/{order_no} add12

GET /api/orders/{id}/tracking add13

adt3

POST /api/payment/create add14

POST /api/payment/balance add15

GET /api/payment/status/{order_id} add16

adt4

GET /api/user/balance add17

POST /api/user/balance/topup add18

GET /api/user/balance/transactions add19

adt5

GET /api/user/coupons add20

GET /api/user/coupons/available add21

POST /api/user/coupons/redeem add22

adt6

GET /api/addresses add23

POST /api/addresses add24

PUT /api/addresses/{id} add25

DELETE /api/addresses/{id} add26

POST /api/addresses/parse add27

adt7

GET /api/user/pre-orders add28

POST /api/user/pre-orders add29

GET /api/user/pre-orders/{id} add30

PUT /api/user/pre-orders/{id} add31

PUT /api/user/pre-orders/{id}/status add32

POST /api/user/pre-orders/{id}/submissions/{sid}/review add33

PUT /api/user/pre-orders/{id}/submissions/{sid}/cancel add34

adt8

GET /api/share/{code} add35

POST /api/share/{code}/submit add36

GET /api/share/{code}/submissions/{sid} add37

GET /api/share/{code}/my-submissions add38

adt9

GET /api/user/after-sales add39

POST /api/after-sales add40

adt10

GET /api/regions add41

GET /api/regions/{id} add42

GET /api/regions/tree add43

GET /api/regions/coverage add44

GET /api/regions/{city_id}/city-coverage add45

GET /api/regions/{id}/express-delivery add46

GET /api/regions/{id}/pickup-points add47

GET /api/agents/referral/{code} add48

GET /api/shipping/config add49

GET /api/shipping/carriers add50

adt11

GET /api/prices add51

GET /api/print-options/sizes add52

GET /api/print-options/paper-types add53

adt12

POST /api/photos/{id}/restore add54

GET /api/restorations/{id} add55

adt13

GET /api/auth/me add56

PUT /api/auth/me add57

adt14

GET /api/printer/status add58

GET /api/print-queue/status add59

GET /api/orders/auto-print-schedule add60

adt15

GET /api/user/api-keys add61

POST /api/user/api-keys add62

DELETE /api/user/api-keys/{id} add63

adt16

GET /api/health add64

Lista de herramientas MCP73

Todas las herramientas siguientes se pueden llamar mediante el protocolo MCP; los clientes de IA las descubren automáticamente tras configurarse.

adt17

upload_document add65 file_url | content | file_path, filename?

list_documents add66

get_document_info add67 document_id

delete_document add68 document_id

adt18

upload_photo add69 file_url | content | file_path, filename?

get_photo add70 photo_id

delete_photo add71 photo_id

check_photo_quality add72 photo_id, size

adt19

create_order add73 items[], delivery_method?, shipping_carrier_id?, coupon_id?

list_orders add74

get_order_status add75 order_id

cancel_order add76 order_id

track_order add77 order_no

get_order_tracking add78 order_id

adt20

create_payment add79 order_id, payment_method?

pay_with_balance add80 order_id

get_payment_status add81 order_id

create_topup add82 amount, payment_method?

get_balance add83

get_balance_transactions add84 page?, page_size?

adt21

list_coupons add85 scope?

get_available_coupons add86 amount?, scope?

redeem_coupon add87 code

adt22

list_addresses add88

create_address add89 name, phone, country, province, city, district, detail, ...

update_address add90 address_id, ...

delete_address add91 address_id

parse_address add92 text, country

adt23

list_pre_orders add93

create_pre_order add94 title, order_type, spec_mode, ...

get_pre_order add95 pre_order_id

update_pre_order add96 pre_order_id, ...

update_pre_order_status add97 pre_order_id, status

review_submission add98 pre_order_id, submission_id, approved, reject_reason?

cancel_submission add99 pre_order_id, submission_id

adt24

get_share_info add100 share_code

submit_share_photos add101 share_code, photo_ids[], password?, ...

get_submission_status add102 share_code, submission_id

list_my_submissions add103 share_code

adt25

list_after_sales add104

create_after_sales add105 order_id, type, reason, ...

adt26

list_regions add106 level?, parent_id?, search?

get_region add107 region_id

get_region_tree add108

get_region_coverage add109

get_city_coverage add110 city_id

get_agent_by_referral add111 referral_code

check_express_delivery add112 region_id

get_shipping_config add113

get_shipping_carriers add114

list_pickup_points add115 region_id

adt27

get_print_prices add116

get_print_options add117

get_printer_status add118

get_queue_status add119

adt28

get_profile add120

update_profile add121 nickname

adt29

restoration_preview add122 photo_id

get_restoration add123 restoration_id

create_restore_share add_sh1 restoration_ids[], message?, expire_days?, max_claims?, with_passcode?

list_my_restore_shares add_sh2 page?, limit?

revoke_restore_share add_sh3 share_id

claim_restore_share add_sh4 code, passcode?

adt30

list_api_keys add124

create_api_key add125 name, expires_in_days?

revoke_api_key add126 api_key_id

adt31

health_check add127

get_auto_print_schedule add128

adt32

submit_order_review add129 order_id, rating_print, rating_shipping?, rating_service?, comment?

batch_submit_order_reviews add130 items[{order_id, rating_print, ...}]

list_my_order_reviews add131 page?, limit?

get_order_review add132 review_id

mark_order_review_read add133 review_id

Ejemplos de código

Un ejemplo completo del flujo «consultar precios → subir archivo → crear pedido → pagar con saldo».

# Consultar precios
curl https://tutupp.com/api/prices \
  -H "Authorization: Bearer tk_YOUR_API_KEY"

# Subir documento
curl -X POST https://tutupp.com/api/documents/upload \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -F "file=@report.pdf"

# Crear pedido
curl -X POST https://tutupp.com/api/orders \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [{
      "document_id": "uuid-here",
      "size": "A4",
      "paper_type": "matte",
      "quantity": 1
    }],
    "delivery_method": "pickup"
  }'

# Pagar con saldo
curl -X POST https://tutupp.com/api/payment/balance \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id": "uuid-here"}'

Flujo de trabajo típico

Subir archivo Consultar precios Crear pedido Pagar con saldo Listo

Manejo de errores

La API usa códigos de estado HTTP estándar; las respuestas de error contienen la info del error en JSON.

// Formato de respuesta de error
{
  "error": "Descripción del error"
}

400

add134 ade0

401

add135 ade1

403

add136 ade2

404

add137 ade3

409

add138 ade4

413

add139 ade5

422

add140 ade6

429

add141 ade7

500

add142 ade8

Límite de tasa: solo las operaciones de escritura sensibles como inicio de sesión / registro / códigos de verificación están protegidas contra ataques; el uso normal nunca lo activa y los umbrales se configuran en el panel de administración. Las respuestas incluyen el campo retry_after_seconds + el encabezado Retry-After.

¿Listo para empezar?

Crea una cuenta, genera una API Key y deja que la IA se encargue de tus impresiones.

Gestionar claves API