Skip to main content
Glama

Autumn MCP by usefulapi

by io.usefulapi
OverviewDiscussionsAdmin

Server Details

MCP server for Autumn — read customers, plans, balances & invoices; track usage and attach plans.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
69.3% over 53 days
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

TDQS

A4/5.0

Scored across 18 tools

Disambiguation5/5

Each tool targets a distinct resource or action: customer vs entity vs plan vs feature vs invoice vs billing operations. The only potential overlap is attach_plan vs preview_attach, but the read-only vs mutating distinction is explicit and clear. The autumn_request escape hatch is well-defined and read-only, so it doesn't create ambiguity.

Naming Consistency4/5

Most tools follow a consistent snake_case verb_noun pattern (get_customer, list_entities, create_entity, update_customer, attach_plan, track_usage). However, 'autumn_request' and 'check' deviate from the pattern, being generic or single-word, which slightly breaks the uniformity.

Tool Count5/5

With 18 tools, the server is well-scoped for a billing and entitlement management domain. Each tool covers a specific operation without redundancy, and the count is within the ideal 3-15+ range for a comprehensive API surface. The number feels appropriate for the breadth of functionality.

Completeness4/5

The tool surface covers core lifecycle operations: customer management (get, create, update, list), entity management (get, create, list), plan/feature retrieval, listing invoices, attaching plans, tracking usage, and checking entitlements. However, there is no explicit detach_plan, delete operations, or a get_invoice by ID, which are minor gaps that agents can work around but could cause friction in certain workflows.

Available Tools

18 tools
attach_planAttach a plan
Destructive
Inspect

MUTATES Autumn billing data — attaches (subscribes) a plan to a customer; may create an invoice / return a payment URL. Autumn API: POST /v1/billing.attach. Returns { customer_id, invoice, payment_url, required_action }.

ParametersJSON Schema
NameRequiredDescriptionDefault
plan_idYesThe ID of the plan.
versionNoThe version of the plan to attach.
customizeNoOptional plan overrides (price, items, licenses, free trial).
entity_idNoThe ID of the entity to attach the plan to.
customer_idYesThe ID of the customer to attach the plan to.
success_urlNoURL to redirect to after a successful checkout.
invoice_modeNoInvoice-mode configuration object (send an invoice instead of auto-charging).
redirect_modeNoCheckout redirect mode: always, if_required, or never.
feature_quantitiesNoPrepaid feature quantities: array of { feature_id, quantity?, adjustable? }.
checkout_session_paramsNoExtra Stripe checkout session params (can carry metadata).
autumn_requestRaw read request
Read-only
Inspect

Power-user escape hatch: POST to any Autumn read/preview endpoint not wrapped by a dedicated tool. READ-ONLY — the path is validated to only allow .get / .list / .check / .preview_* actions; write actions are rejected. Autumn API: POST {path}.

ParametersJSON Schema
NameRequiredDescriptionDefault
bodyNoJSON body object to POST (the endpoint's params).
pathYesFull API path, e.g. "/v1/customers.get". Only read/preview suffixes are allowed.
checkCheck feature access / balance
Read-only
Inspect

READ-ONLY entitlement check: does a customer have access to (or enough balance of) a feature? Autumn API: POST /v1/balances.check. This tool never records usage — it does not expose send_event or lock.

ParametersJSON Schema
NameRequiredDescriptionDefault
entity_idNoEntity id for entity-scoped balances (e.g. per-seat limits).
feature_idYesThe ID of the feature to check.
customer_idYesThe ID of the customer.
with_previewNoInclude upgrade/upsell (paywall) info in the response when access is denied.
required_balanceNoMinimum balance required for access. Returns allowed:false if below. Defaults to 1.
create_entityCreate an entity
Destructive
Inspect

MUTATES Autumn billing data — creates an entity (e.g. a seat) under a customer, tied to a feature. Autumn API: POST /v1/entities.create.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoThe name of the entity.
entity_idYesThe ID of the entity.
feature_idYesThe ID of the feature this entity is associated with.
customer_idYesThe ID of the customer to create the entity for.
billing_controlsNoOptional billing controls for the entity (spend/usage limits).
get_customerGet a customer
Read-only
Inspect

Fetch a single Autumn customer by id, optionally expanding related data (invoices, entities, subscriptions, balances). Autumn API: POST /v1/customers.get.

ParametersJSON Schema
NameRequiredDescriptionDefault
expandNoRelated data to expand, e.g. invoices, entities, subscriptions.plan, purchases.plan, balances.feature.
customer_idYesYour unique identifier for the customer.
get_entityGet an entity
Read-only
Inspect

Fetch a single entity (e.g. a seat) belonging to a customer. Autumn API: POST /v1/entities.get.

ParametersJSON Schema
NameRequiredDescriptionDefault
expandNoRelated data to expand, e.g. invoices, entities, subscriptions.plan, purchases.plan, balances.feature.
entity_idYesThe ID of the entity.
customer_idYesThe ID of the customer that owns the entity.
get_featureGet a feature
Read-only
Inspect

Fetch a single feature by id. Autumn API: POST /v1/features.get.

ParametersJSON Schema
NameRequiredDescriptionDefault
feature_idYesThe ID of the feature.
get_or_create_customerGet or create a customer
Destructive
Inspect

MUTATES Autumn billing data — fetches a customer by id, creating them if they do not exist. Autumn API: POST /v1/customers.get_or_create.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoCustomer's name.
emailNoCustomer's email address.
expandNoRelated data to expand, e.g. invoices, entities, subscriptions.plan, purchases.plan, balances.feature.
currencyNoCurrency to bill this customer in (e.g. usd, eur).
metadataNoArbitrary key/value metadata for the customer.
stripe_idNoExisting Stripe customer id, if any.
customer_idYesYour unique identifier for the customer (null to create an anonymous customer).
fingerprintNoUnique identifier to detect duplicate customers / prevent free-trial abuse.
create_in_stripeNoWhether to create the customer in Stripe.
get_planGet a plan
Read-only
Inspect

Fetch a single plan by id (optionally a specific version). Autumn API: POST /v1/plans.get.

ParametersJSON Schema
NameRequiredDescriptionDefault
plan_idYesThe ID of the plan to retrieve.
versionNoThe plan version to get. Defaults to the latest.
list_customersList customers
Read-only
Inspect

List/filter customers with cursor pagination. Autumn API: POST /v1/customers.list. Returns { list, next_cursor }.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoPage size, 1-5000. Default 50.
plansNoFilter by plan: array of { id, versions? } objects.
searchNoSearch customers by id, name, or email.
processorsNoFilter by processor type: stripe, revenuecat, vercel.
start_cursorNoPagination cursor from a prior response's `next_cursor` (omit / empty for first page).
subscription_statusNoFilter by status: "active" or "scheduled". Defaults to both.
list_entitiesList entities
Read-only
Inspect

List a customer's entities with cursor pagination and optional filters. Autumn API: POST /v1/entities.list. Returns { list, next_cursor }.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoPage size, 1-5000. Default 50.
plansNoFilter by plan: array of { id, versions? } objects.
searchNoSearch entities by id or name.
processorsNoFilter by parent customer processor: stripe, revenuecat, vercel.
customer_idYesRestrict the response to entities owned by this customer id.
start_cursorNoPagination cursor from a prior response's `next_cursor` (omit / empty for first page).
subscription_statusNoFilter by status: "active" or "scheduled". Defaults to both.
list_featuresList features
Read-only
Inspect

List all features in the current environment. Autumn API: POST /v1/features.list. Returns { list }.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

list_invoicesList invoices
Read-only
Inspect

List invoices with cursor pagination and optional filters. Autumn API: POST /v1/invoices.list. Returns { list, next_cursor }.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoPage size, 1-5000. Default 50.
statusNoFilter by invoice status: draft, open, paid, void, uncollectible.
entity_idNoFilter to a single entity by id (must be paired with customer_id).
customer_idNoFilter to a single customer by id.
start_cursorNoPagination cursor from a prior response's `next_cursor` (omit / empty for first page).
processor_typesNoFilter by processor: stripe, revenuecat.
list_plansList plans
Read-only
Inspect

List all plans (products) in the current environment. Autumn API: POST /v1/plans.list. Returns { list }.

ParametersJSON Schema
NameRequiredDescriptionDefault
entity_idNoEntity id for entity-scoped plans.
customer_idNoInclude eligibility info (trial availability, attach scenario) for this customer.
all_versionsNoIf true, include all plan versions.
include_archivedNoIf true, include archived plans.
open_customer_portalOpen customer billing portal
Destructive
Inspect

MUTATES Autumn billing data — creates a Stripe billing-portal session for a customer to manage their subscription. Autumn API: POST /v1/billing.open_customer_portal. Returns { customer_id, url }.

ParametersJSON Schema
NameRequiredDescriptionDefault
return_urlNoURL to redirect to when the back button is clicked in the portal.
customer_idYesThe ID of the customer to open the billing portal for.
configuration_idNoStripe billing-portal configuration id.
preview_attachPreview attaching a plan
Read-only
Inspect

Preview the cost/effect of attaching a plan to a customer WITHOUT charging or changing anything. Read-only. Autumn API: POST /v1/billing.preview_attach.

ParametersJSON Schema
NameRequiredDescriptionDefault
plan_idYesThe ID of the plan.
versionNoThe version of the plan to attach.
customizeNoOptional plan overrides (price, items, licenses, free trial).
entity_idNoThe ID of the entity to attach the plan to.
customer_idYesThe ID of the customer to attach the plan to.
feature_quantitiesNoPrepaid feature quantities: array of { feature_id, quantity?, adjustable? }.
track_usageTrack usage
Destructive
Inspect

MUTATES Autumn billing data — records a usage event (deducts/credits a feature balance). Provide EITHER feature_id OR event_name. Autumn API: POST /v1/balances.track.

ParametersJSON Schema
NameRequiredDescriptionDefault
valueNoAmount of usage to record. Defaults to 1. Negative values credit the balance.
entity_idNoEntity id for entity-scoped balances.
timestampNoUnix timestamp (ms) for the event. Defaults to now.
event_nameNoEvent name to track usage for. Provide this OR feature_id.
feature_idNoThe feature to track usage for. Provide this OR event_name.
propertiesNoAdditional properties to attach to the usage event.
customer_idYesThe ID of the customer.
idempotencyKeyNoOptional key to dedupe retried events.
update_customerUpdate a customer
Destructive
Inspect

MUTATES Autumn billing data — partially updates a customer. Only provided fields change. Autumn API: POST /v1/customers.update.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoCustomer's name.
emailNoCustomer's email address.
currencyNoCurrency to bill this customer in (e.g. usd, eur).
metadataNoArbitrary key/value metadata for the customer.
stripe_idNoStripe customer id.
customer_idYesID of the customer to update.
fingerprintNoDuplicate-detection fingerprint.
new_customer_idNoNew id for the customer.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 18 tool updates
    • Changedattach_plan1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedautumn_request1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedcheck1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedcreate_entity3 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / properties / name / anyOf
        Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedInput schema / properties / name / type
        Added value: +[
+  "string",
+  "null"
+]
    • Changedget_customer1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedget_entity1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedget_feature1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedget_or_create_customer3 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / properties / customer_id / anyOf
        Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedInput schema / properties / customer_id / type
        Added value: +[
+  "string",
+  "null"
+]
    • Changedget_plan1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlist_customers1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlist_entities1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlist_features1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlist_invoices1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlist_plans1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedopen_customer_portal1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedpreview_attach1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedtrack_usage1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedupdate_customer11 fields changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
      • removedInput schema / properties / currency / anyOf
        Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedInput schema / properties / currency / type
        Added value: +[
+  "string",
+  "null"
+]
      • removedInput schema / properties / email / anyOf
        Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedInput schema / properties / email / type
        Added value: +[
+  "string",
+  "null"
+]
      • removedInput schema / properties / fingerprint / anyOf
        Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedInput schema / properties / fingerprint / type
        Added value: +[
+  "string",
+  "null"
+]
      • removedInput schema / properties / name / anyOf
        Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedInput schema / properties / name / type
        Added value: +[
+  "string",
+  "null"
+]
      • removedInput schema / properties / stripe_id / anyOf
        Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
      • addedInput schema / properties / stripe_id / type
        Added value: +[
+  "string",
+  "null"
+]
  2. 18 tool updates
    • First observedattach_plan
    • First observedautumn_request
    • First observedcheck
    • First observedcreate_entity
    • First observedget_customer
    • First observedget_entity
    • First observedget_feature
    • First observedget_or_create_customer
    • First observedget_plan
    • First observedlist_customers
    • First observedlist_entities
    • First observedlist_features
    • First observedlist_invoices
    • First observedlist_plans
    • First observedopen_customer_portal
    • First observedpreview_attach
    • First observedtrack_usage
    • First observedupdate_customer

Related MCP Connectors

Related MCP Servers

  • Autumn MCP Server

    SirTenzin
    A
    license
    Not graded
    quality
    D
    maintenance
    An unofficial MCP server that provides an interface to access the Autumn pricing API for managing customers, entitlements, invoices, and generating billing portal links.
    9
    MIT

  • chargebee-mcp

    MSPbotsAI
    A
    license
    A
    quality
    B
    maintenance
    MCP server wrapping the Chargebee REST API to manage customers, subscriptions, invoices, and transactions.
    10
    Apache 2.0

  • datagate-mcp

    hyamie
    A
    license
    B
    quality
    C
    maintenance
    MCP server for the DataGate billing platform API, providing read-only tools to manage customers, invoices, products, agreements, sites, and payments.
    13
    MIT

  • mcp-server-billing

    santimentasti
    F
    license
    Not graded
    quality
    C
    maintenance
    MCP server providing guarded access to a B2B SaaS billing database (customers, subscriptions, invoices, credit notes) and live ECB exchange rates, with read-only tools and one capped, idempotent write for issuing credit notes.
    -
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources