# Printavo MCP > Printavo lets your AI agent manage your entire custom apparel shop. You connect Printavo to any client—Claude, Cursor, or another MCP-compatible app—and control everything from customer records to production schedules. Use natural language commands to list orders, create new quotes, check status updates, and build out detailed billing information without ever switching apps. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** shop-management, order-tracking, production-scheduling, custom-apparel, invoicing ## Description When you connect Printavo to your AI agent, you get complete control over your custom apparel shop's workflow using plain English commands. You don't gotta jump between dashboards; your agent handles everything from customer intake to production billing right in the chat window. ### Customer Management Tools The `list_customers` tool lets you pull a list of every person or company that’s ever used your shop. Need more info on one client? You use `get_customer_details` to retrieve all stored information for a specific customer record. If you have a brand-new organization, the `create_customer` tool adds them right into your central database. When customers reach out with questions or requests, the `list_inquiries` tool shows you a list of their recent contact messages. ### Order Creation and Retrieval Tools The `list_orders` tool pulls a summary rundown of every single job currently in the shop. If you need to build a brand-new quote or start a new job, the `create_order` tool generates it based on the data you provide. To get everything about an existing job—down to the minute detail—you pull granular information with `get_order_details`. For maximum visibility into what was ordered, `list_line_items` breaks down every individual product item associated with that specific order number. You'll also find payment history; run `list_payments` to see all recorded transactions linked to an existing job. ### Production and Status Tracking Tools The `list_order_statuses` tool gives you a definitive list of every official status configured in your shop—like 'In Progress' or 'Awaiting Approval'—so you know the exact workflow stages. You track production movement using `update_order`, which lets you change details for any job already in the system, whether it’s moving its status forward or adding necessary notes to the file. To keep tabs on current work, your agent can retrieve a simple summary of all jobs via `list_orders`. If a client needs a specific update, you use `get_order_details` again. You can also check out how many people are waiting for updates by calling `list_customers` and then checking the status history with `list_inquiries`. ### Putting It Together: The Workflow Your AI agent acts like an embedded production manager, handling complex data interactions without you touching a dashboard. You can list all current shop orders using `list_orders`. Need to know where that order stands? Check the job status with `list_order_statuses`, then pull the specific details for it via `get_order_details`. If you need to change something—say, moving it from 'Printed' to 'Shipped'—you just run `update_order`. You can check out who paid for that whole shebang using `list_payments`. To keep your records clean, when a new client walks in, you use `create_customer` and then immediately generate their first job with `create_order`. If they have questions before the order is done, run `list_inquiries` to see what they're asking about. You can pull all customer info using `get_customer_details` or get a whole rundown of every client using `list_customers`. The entire process—from inquiry logging via `list_inquiries` to final billing data checks through `list_line_items` and payment verification with `list_payments`—is controlled by conversation. ## Tools ### create_customer Adds a new customer record into your shop's database. ### create_order Creates a brand-new job or quote based on the data you provide. ### get_order_details Pulls every piece of data associated with a single job number. ### list_customers Lists all customers currently in your Printavo account. ### list_orders Retrieves a summary list of every print shop order. ### list_order_statuses Gets a list of all official job statuses configured in your shop (e.g., In Progress, Awaiting Approval). ### get_customer_details Retrieves all stored information for one specific customer. ### list_inquiries Shows you a list of recent questions or requests from customers. ### list_line_items Breaks down every product item listed under a specific order. ### list_payments Shows all payment records associated with an existing order. ### update_order Changes details for a job that is already in the system, like updating the status or adding notes. ## Prompt Examples **Prompt:** ``` List all active orders in my Printavo shop. ``` **Response:** ``` I've retrieved your orders. You have 5 active jobs including 'High School Seniors 2024' (Status: In Production) and 'Tech Conference Tees'. Which one would you like to see more details for? ``` **Prompt:** ``` Show me all orders currently in production with their due dates and customer details. ``` **Response:** ``` 24 orders currently in production. 5 are due today: "Meridian Corp Polos" (200 units, screen print), "Tech Summit T-Shirts" (500 units, DTG), "Valley School Hoodies" (150 units, embroidery), "Startup Branded Caps" (300 units), and "Restaurant Staff Uniforms" (75 units). 8 orders are due within the next 3 days. 3 orders are flagged as at-risk due to material shortages. Total production value: $47,800. ``` **Prompt:** ``` Create a new order for Tech Summit requesting 500 custom t-shirts with front and back printing. ``` **Response:** ``` Order created: #ORD-4892. Customer: Tech Summit Events. Product: Custom T-Shirts x 500. Decoration: Screen print (front: full color logo, back: event schedule). Sizes: S(50), M(150), L(200), XL(75), 2XL(25). Base color: Navy Blue. Production estimate: 5 business days. Total quote: $4,750 ($9.50/unit). Status set to "Pending Approval". Customer notification email sent with approval link. ``` ## Capabilities ### List all shop orders Your agent retrieves a list of every current job in the print shop. ### Create new customer records The AI adds a brand-new organization or contact into your central customer database. ### Get specific order data You pull granular details for one job, including line items and billing components. ### Track production status The agent lists all configured statuses so you know where a job stands in the workflow. ### List customer inquiries You pull a list of recent contact requests or questions from your customers. ## Use Cases ### Checking on multiple jobs at once A manager needs to know which orders are stuck. They ask the agent, 'What is the status of all Tech Summit and Meridian Corp orders?' The agent runs `list_orders` and provides a summary, identifying stalled jobs that need attention. ### New client onboarding A CSR gets a call from a new client. They ask the agent to create them: 'Add Tech Summit Events as a customer.' The agent uses `create_customer`, instantly adding the record so the team can start quoting. ### Processing an initial quote An employee needs to give a quick price estimate. They prompt, 'Create an order for 500 shirts.' The agent uses `create_order`, generating a draft quote and setting the status to 'Pending Approval' in one command. ### Billing follow-up The team needs to verify if the last payment went through. They ask, 'What payments are linked to order #ORD-4892?' The agent calls `list_payments` and gives a clear report on transactions. ## Benefits - Track job progress instantly. Instead of logging into the dashboard, ask your agent to `list_orders` or check specific statuses using `list_order_statuses`. You see bottlenecks immediately. - Never lose customer data again. Use `create_customer` and `get_customer_details` to manage contacts directly through conversation. No copying names between systems. - Automate quoting. The agent can use `create_order` to generate a complete quote, including line item totals and estimated production time, saving you manual calculation time. - Full visibility into billing. Need to know if an order is paid? Use `list_payments` for a clear record of every payment against that specific job. - Handle complex updates easily. If a customer changes their mind or a status moves, use `update_order`. It's direct and requires less context switching than navigating forms. ## How It Works The bottom line is: you talk to your AI client, and it uses Printavo's tools to get the data you need, keeping you in one chat window. 1. Subscribe to the Printavo MCP Server and provide your API Key and login email. 2. Connect the server to your preferred client (Claude, Cursor, etc.). 3. Tell your agent what you need—for instance, 'List all orders due next week.' The agent translates that into a tool call (`list_orders`) and gives you the answer. ## Frequently Asked Questions **How do I list my customers using Printavo MCP Server?** Run `list_customers`. This tool pulls all the names and contact info for every organization saved in your shop, giving you a quick overview of your client base. **Can I update an order status with the Printavo MCP Server?** Yes, use the `update_order` tool. You must provide the specific Order ID and the new status or details; it won't change anything without that information. **What is the difference between `create_order` and `get_order_details`?** `create_order` builds a brand-new job or quote. `get_order_details` reads all existing information from an order that's already been created in Printavo. **Do I need to run list_payments before running get_order_details?** No. They are separate tools for different data types. Use `get_order_details` first to see the general job info, then use `list_payments` if you specifically need payment history. **How do I use `list_line_items` to break down a specific order's contents?** It returns every product line item associated with an order. This lets you confirm exact SKUs, quantities, and decoration methods without needing the full details from `get_order_details`. It’s perfect for auditing job components. **When should I use `list_inquiries` instead of `get_customer_details`?** Use this tool to see the history of communication, not just static profile data. It tracks specific customer questions or requests submitted through Printavo’s portal, giving you a full service interaction log. **Does `create_order` require any special JSON formatting?** Yes, it expects structured data inputs. You must pass all required fields—including product codes, quantities, and client names—in the correct JSON format for the order creation to succeed. **How do I check what production statuses are available using `list_order_statuses`?** This tool retrieves every defined status within your shop. You use this list to confirm the precise terminology before attempting any updates or reports, ensuring you don't misspell a workflow stage. **Can my AI automatically find the details for a specific order by providing its ID?** Yes! Use the `get_order_details` tool with the Order ID. Your agent will respond with complete metadata, including totals, line items, and current production status in seconds. **How do I find my Printavo API Key?** Log in to your Printavo account, navigate to **My Account**, and you will find or generate your unique secret API key there. **Can I create a new customer via the AI?** Yes, use the `create_customer` tool. Provide the customer name and other metadata, and the agent will add the record to your Printavo CRM immediately.