NewMaxio Metering is now available — usage-based billing for Advanced Billing.Learn more
/

Review Maxio MCP Supported Tools

··

Last updated on Sep 19, 2026

Every tool the Maxio Model Context Protocol (MCP) exposes, grouped by the platform it reaches. Which of them your AI client can call depends on the role you assigned the connector.

What each role can reach

Two roles are available, and the narrower one covers most reporting work.

Analyst, read-only

The Analyst role is designed for safe data access, reporting, and analysis. It includes only read operations and does not allow data creation or modification.

  • All Maxio (General) tools
  • All Advanced Billing read tools
  • All Maxio Core read tools

Best for: Reporting, analysis, auditing, and customer support workflows.

Bookkeeper, read and create

The Bookkeeper role includes everything in the Analyst role, plus the ability to create and manage billing and transaction data.

  • All Analyst tools

In Advanced Billing it adds:

  • Create Component
  • Create Coupon
  • Create Customers
  • Create Product Family
  • Create Product
  • Create Subscription

In Maxio Core it adds:

  • Create Sales Order

Best for: Finance, billing operations, and workflow execution.

Tools that span both platforms

One tool gives the client its bearings before it calls anything else.

ToolWhat it does
About Current AccountReturns Advanced Billing and Maxio Core endpoints along with key account metadata to provide context for other tool calls.

Advanced Billing tools

Create tools here are available only to the Bookkeeper role.

ToolWhat it does
Create ComponentCreates a quantity-based component within the product catalog, supporting tiered pricing and schemes.
Create CouponBuilds percentage- or amount-based coupons scoped to product families, with optional restrictions.
Create CustomersAccepts an array of customer payloads to bulk-create records, with per-record error handling.
Create Product FamilyRegisters a new product family container to organize related products and components.
Create ProductAdds a new product to a family with interval, pricing, trial, and accounting metadata.
Create SubscriptionProvisions a subscription (remittance only) using customer, pricing, coupon, and component options under PCI-safe constraints.
List Advanced Billing SubscriptionsReturns a paginated, filterable list of subscriptions by state, product, or price point.
Search Customer by ReferenceLooks up a Customer using an external reference ID and enriches the result with custom fields and Subscriptions.
Show Advanced Billing CustomersRetrieves Customer records (optionally by ID or query), including Subscriptions and custom fields.
Show Product CatalogAggregates the full product catalog, including families, products, components, coupons, and site metadata.
Show Advanced Billing SubscriptionsRetrieves detailed subscription records (by ID), including payment profiles, custom fields, Invoices, and components.

Maxio Core tools

Mostly reporting and retrieval, plus one create tool.

ToolWhat it does
Create Sales Order in Maxio CoreCreates a sales order and nested line items in Maxio Core for downstream billing and revenue workflows.
Download Existing Report RunPulls a previously run report using a report run ID. Returns either CSV data or a secure download link.
Generate Maxio One Click ReportRuns a selected report, waits for export, downloads the CSV, and renders the data.
List Reports (search)Lists available Maxio report definitions, including IDs, names, descriptions, and URLs for downstream usage.
Fetch ReportGenerates a selected Maxio report using the GenerateReportTool and returns its contents by ID.
List Maxio Core ContractsLists contracts with pagination and filters (Customer, register, Maxio ID) with register preloading.
List Maxio Core CustomersPaginates Customers or retrieves specific IDs, returning authoritative records.
List Maxio Core InvoicesReturns Invoices with pagination and filters for Customer, contract, or register.
List Maxio Core PaymentsLists payments, refunds, or credits filtered by type, Customer, source, currency, and contract.
Listing Maxio ProjectsReturns all Maxio Project objects configured for the current account.
Listing Maxio ReportsOutputs all report definitions and IDs required for triggering report generation.
List Maxio Core Sales OrdersPaginates sales orders, filters by creation date, and excludes integration-specific fields.
List Maxio Core TransactionsRetrieves Transactions by Customer, contract, item, or register with preloaded metadata.
Retrieve Maxio Core Contract DetailsCombines contract metadata, analytics, and register data into one view.
Retrieve Customer DetailsReturns a comprehensive Customer dashboard with analytics, contracts, Invoices, Transactions, and payments.
Retrieve Maxio Core Invoice DetailsProvides enriched Invoice data, including item-level details.
Retrieving Project with DetailsOutputs a project and associated milestones and triggers for workflow analysis.

For prompts that call these tools, see the Review Example Prompts for Maxio MCP Tools help article.

To choose the role that grants them, see the Configure the Maxio MCP Connector help article.

If a report tool fails with an Amazon S3 error, see the Troubleshoot MCP Report Retrieval Errors help article.

Still need help?
Reach out and our support team will take it from here.

Contact support