Komashi

Delete an overlay customer (current provider).

delete-customer-tool

Generate a magic login URL for a customer to access the customer portal.

generate-magic-url-tool

Get a single contact of a customer.

get-customer-contact-tool

Get a single customer by ID (overlay for current provider).

get-customer-tool

Get a single invoice by its UUID, including a temporary download URL for the PDF/XML document.

get-invoice-tool

Return the authenticated user's short-lived Komashi provider-onboarding context. Use the session id supplied by the Komashi onboarding screen to prefill business name, logo, country, language and service setup. OAuth authentication is still required.

get-onboarding-context-tool

Get a single period by ID for a given service plan.

get-period-tool

Get a single plan by ID for a given service.

get-plan-tool

Get a single addon option by ID for a given service addon.

get-service-addon-option-tool

Get a single addon by ID for a given service.

get-service-addon-tool

Get a single service by ID.

get-service-tool

Get a single non-draft subscription by its Subscription ID. Returns individual subscription data including the group_id field — all subscriptions from the same checkout share the same group_id. Use CheckGroupUsageTool or GroupShowTool with the group_id to retrieve aggregated group data.

get-subscription-tool

Get instructions for drafting a privacy policy for the selected Komashi business. Returns a writing prompt populated from the authenticated provider and its non-customer service catalogue. Use the returned prompt to write the draft in the conversation. This tool does not generate, publish, save or send the legal document itself. If this tool is unavailable in ChatGPT, ask the user to install or activate the Komashi Plugin.

get_privacy_policy_drafting_instructions

Get instructions for drafting terms of service for the selected Komashi business. Returns a writing prompt populated from the authenticated provider and its non-customer service catalogue. Use the returned prompt to write the draft in the conversation. This tool does not generate, publish, save or send the legal document itself. If this tool is unavailable in ChatGPT, ask the user to install or activate the Komashi Plugin.

get_terms_of_service_drafting_instructions

Get all subscriptions in a provider-scoped group by Group ID. Returns the service, billing type, member subscriptions, and aggregate usage, limits, dates, and status. Recurring groups contain a parent and optional addon subscriptions; one-time groups contain purchase subscriptions. Use a Group ID, not a Subscription ID. Use CheckGroupUsageTool when only group usage totals are needed. This tool only reads existing group data.

group-show-tool

List all contacts for a given customer.

list-customer-contacts-tool

List all customers for the authenticated provider.

list-customers-tool

List coupon discount templates for the authenticated provider. Discounts can be composed in the Komashi admin interface and then used by discount_id when creating subscriptions.

list-discounts-tool

List invoices of the authenticated provider, including temporary download URLs. Supports filtering by customer, invoice number, and date range (created_from / created_to).

list-invoices-tool

List all periods for a given service plan.

list-periods-tool

List all plans for a given service.

list-plans-tool

List the Komashi providers that the authenticated user can access. Use select_provider before provider-scoped tools when more than one provider is available.

list-providers-tool

List all options for a given service addon.

list-service-addon-options-tool

List all addons for a given service.

list-service-addons-tool

List all services for the authenticated provider.

list-services-tool

List subscriptions for a service. Supports pagination, status, external_reference and date filters. Each subscription in the response includes a group_id field — use the group_id with group endpoints to retrieve the full subscription group.

list-subscriptions-tool

Save user-confirmed business setup details in a temporary Komashi onboarding session. This tool does not create a business or service record; it returns the collected fields and the next setup step. On the first turn after the setup request, ask which business the user wants to configure and wait for the answer; do not call this tool before that answer, even if context suggests a single business. Have a real conversation with the user and never silently choose a business, service or setting on the user's behalf. Before collecting setup data, identify the business the user wants to configure. Even if exactly one business or project is plausible, present it and wait for explicit confirmation; if several are plausible, show a short numbered list, mark the most likely option as recommended, and wait for the user's choice. Always offer "None of these — describe a new business." If the user names another business, try to find and inspect its public website; if no reliable website can be found or reached, ask the user for its URL and stop instead of inventing facts. After the business is confirmed, prepare a factual draft of at least five complete sentences and store it as a safe draft; request explicit approval only before the final completion step. Inspect the confirmed website homepage, about, service, pricing, FAQ, terms and contact pages where available. Handle the logo as a separate short checkpoint: show a reliable website logo candidate and ask whether to use it, or accept a direct logo URL or an accessible ChatGPT/Claude upload URL supplied by the user. Only pass a confirmed accessible image URL in logo; never claim to have received an inaccessible attachment. Then identify exactly one primary service, show its name and description as a draft, and wait for explicit confirmation. Discuss consequential settings with the user, including website, service language, country, VAT mode, billing and renewal behaviour, storefront, multi-subscription setting and the desired subdomain; recommend a subdomain if useful, but never choose it silently. Use reliable context without making the user repeat it, but never invent facts or run a field-by-field interview. Store only values the user has confirmed. Never ask the user for a setup hash or session id. The setup_session input is optional; when omitted, use the authenticated user's active setup session and create one automatically if needed. This tool only stores the user-bound setup session; it does not create a provider. Call complete_provider_setup only after the user explicitly approves the complete final summary, including the business, one service and settings; a draft, supplied facts or prior conversation is not approval.

save_business_setup_details

Save user-confirmed service setup details in a temporary Komashi onboarding session for the selected business. Returns the collected fields and the next setup step. This safe draft action stores only user- and provider-bound setup data and never creates or modifies the service record. When the provider is already supplied by Komashi, do not ask the user to select it again. Merge repeated safe edits into the same session without requesting redundant confirmation; ask for confirmation only before the consequential final create step. Collect the service name, factual description, language, self-service or provider-managed mode, storefront visibility, recurring or one-time billing, multiple subscriptions and VAT sale type. Call complete_service_setup only after the user explicitly approves the complete final summary. Never ask the user for a setup hash or session id.

save_service_setup_details

Select one of the authenticated user's Komashi providers for the current MCP session. This never grants access to providers that are not linked to the authenticated user.

select-provider-tool

Sync subscription usage/consumption by setting an absolute total usage value (e.g. queries, credits). If the submitted value exceeds the usage limit, the API returns a 422 error with details. After a successful sync, the API dispatches a subscription.usage.updated webhook and returns the current usage status. Use AdjustUsageTool for incremental adjustments.

sync-usage-tool

Update an existing customer contact.

update-customer-contact-tool

Update an overlay customer (current provider). Uses same required fields as create.

update-customer-tool

Update lifecycle dates of a non-draft subscription.

update-subscription-dates-tool

Set the lifecycle status of a non-draft subscription.

update-subscription-status-tool