# Ezus MCP MCP > Ezus MCP gives your AI agent full control over travel agency operations. Manage everything—from active projects and client records to supplier contacts, product catalogs, and financial invoices. You can query or update any core business asset using natural conversation. ## Overview - **Category:** customer-relationship-management - **Price:** Free - **Tags:** travel-agency-software, itinerary-management, supplier-management, crm, financial-flows, booking-automation ## Description You connect your Ezus management account directly to your preferred AI agent. This lets you run complex tasks without ever leaving your chat window. Instead of jumping through multiple tabs, manually searching for client IDs, then switching over to a different system just to check billing status, you talk to your agent and it handles the whole workflow. It retrieves current project details, lists all active clients, checks which products are available in the catalog, or even finds specific invoices by ID. This means your AI agent knows how to manage every part of the business—your people, your money, and your services. By connecting Ezus through Vinkius, you get a single point of control over your entire agency’s backend data. ## Tools ### list_projects Provides an overview and list of all current projects, allowing you to check statuses. ### list_suppliers Lists all vendors and partners your agency works with. ### upsert_project Creates a brand new project or updates an existing one with new details. ### get_client Retrieves all details for one specific customer by their ID. ### get_invoice Pulls up the full details for a single invoice using its unique ID. ### get_me Retrieves the profile information for the API user connected to this MCP instance. ### get_product Shows the details for one specific travel product or package by its ID. ### get_project Retrieves the full record of a single travel project by its ID. ### get_supplier Fetches the details for one specific vendor or supplier by their ID. ### list_clients Shows a list of every client record in your system. ### list_invoices Provides an overview and list of all invoices recorded in your account. ### list_products Lists all available products and packages in your catalog. ## Prompt Examples **Prompt:** ``` List my recent travel projects on Ezus. ``` **Response:** ``` I've retrieved your projects. You have 'Summer in Paris' (ID: 789) and 'Tokyo Explorer' (ID: 456) currently active. Would you like to see the details for any of these? ``` **Prompt:** ``` Show me the details for client ID 12345. ``` **Response:** ``` Inspecting client 12345... This is 'John Doe', a frequent traveler with a preference for luxury stays. They are currently associated with the 'Swiss Alps Adventure' project. ``` **Prompt:** ``` Get all products available in the catalog. ``` **Response:** ``` Fetching catalog... I found 12 products including 'Safari Package', 'Guided City Tour', and 'Airport Transfer'. Which one should I inspect further? ``` ## Capabilities ### Find client and vendor details Retrieve specific client profiles or list every supplier in your network with simple commands. ### Track and update projects List all current travel itineraries, check project status, or create a new project record directly from the chat. ### Manage financials Get detailed information on any specific invoice by its ID, or pull up lists of all outstanding bills for accounting review. ### Review product inventory Browse the full catalog of travel products and packages available to your agency clients. ### Identify user credentials Pull core profile information for the API user running the connection, useful for troubleshooting or auditing. ## Use Cases ### Client needs quick project status and billing info A client asks, 'What's the status of my trip to Rome?' Your agent runs list_projects first, finding the correct ID. Then it uses get_client to pull their contact details and finally checks list_invoices to confirm if the deposit payment has cleared. ### Updating a supplier's contract information The ops team finds that 'Local Tours Inc.' changed its primary contact. They use get_supplier to pull up the old record, then run upsert_project with the new details and updated credentials. ### Checking profitability on a new booking The manager wants to know if the 'Safari Package' is profitable for this client. They use get_product to check the package cost, list_clients to confirm the billing entity, and then run get_invoice to see payment history. ### Onboarding a new vendor into the system The team gets a new local guide. Instead of filling out multiple forms, they use list_suppliers to verify existing vendors and then run upsert_project with all the necessary initial data points for the new supplier. ## Benefits - Stop context switching. Instead of going to the CRM for a client profile, then opening your accounting software for invoices, you simply ask your agent to check both things at once. - Keep project data current instantly. You can use upert_project or list_projects to update travel plans and statuses without manually logging into a separate dashboard. - Improve billing accuracy by checking invoices. Use get_invoice or list_invoices to verify payment status before sending out any follow-up emails. - Streamline vendor management. You can run list_suppliers to see who you work with, then use get_supplier to pull specific contact details on demand. - Understand your full inventory. Quickly check what's available by running list_products or examining a single item using get_product. ## How It Works The bottom line is that your AI client becomes an expert employee, accessing all your agency's back-end records instantly when you ask it to. 1. Subscribe to this MCP and provide your Ezus API key, email, and password credentials. 2. Connect your agent (like Claude or Cursor) to the Vinkius platform. 3. Ask your AI client a question using natural language. The agent uses the available tools to pull data and answer you. ## Frequently Asked Questions **How do I use the get_client tool with Ezus?** You provide the client ID directly to your agent when asking for details. The agent runs get_client and returns a full profile, including contact info and history. **What is the difference between list_clients and get_client in Ezus?** list_clients gives you an overview of every client ID available. You use get_client only when you know the specific ID and need all their detailed information. **Can I update a project using upsert_project?** Yes, upsert_project handles both creating brand new projects and updating existing ones. You just give it the necessary IDs and the new data points you want to change. **Do I need list_invoices before checking a specific invoice?** No, you don't. While list_invoices gives an overview of all bills, you can skip straight to get_invoice if you already have the precise ID. **Where do I check product pricing? Using get_product?** You use get_product by providing the specific product ID. This returns the current details, including pricing and availability for that single package. **If I run list_clients, does the MCP handle pagination for large datasets?** Yes, it handles it. The tool automatically returns data in batches. Your agent receives a next page token or cursor you can use to pull every client record without hitting rate limits. **When I use upsert_project, how does the MCP manage conflicts?** It uses the Project ID as the primary key. If data in a field conflicts with existing information, it updates the record by default, but you can build logic into your agent to confirm overwrites for critical fields. **Does running get_me show my current API user's permissions?** It does. The `get_me` tool retrieves detailed credentials and profile information for the user linked to your MCP connection. This lets you check permissions before automating sensitive tasks. **How do I obtain my Ezus API Key?** You can find your API Key in the Ezus settings under the 'Integrations' or 'API' section. Note that a Premium plan may be required for private API access. **Can I update existing projects using this integration?** Yes! Use the `upsert_project` tool. If you provide an existing Project ID, it will update the project; otherwise, it will create a new one. **Is it possible to list invoices to track payments?** Absolutely. The `list_invoices` and `get_invoice` tools allow you to retrieve financial records and check their current status.