Autumn MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.37.5Updated Nov 8, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for Autumn billing: lets an assistant read customers, plans, features, balances and invoices, and record usage or attach plans.

What you can do
  • Look up and list customers, entities (such as seats), features and plans, with cursor pagination and optional expansion of related data.
  • List invoices and check whether a customer has access to, or enough balance of, a feature without recording usage.
  • Preview the cost and effect of attaching a plan to a customer without charging or changing anything.
  • Send a raw read-only request to any Autumn get, list, check or preview endpoint not covered by a dedicated tool.
  • Create or update customers, create entities, track usage events, attach plans and open a Stripe billing portal session.
  • Check this server's own usage meter, request a missing feature, upgrade or cancel the subscription.
When to use it
Useful when you work with Autumn as your billing or entitlement system and want to query subscriptions, plans, balances and invoices conversationally, or make routine billing changes such as recording usage or attaching a plan, without leaving the assistant.
Requirements
Remote endpoint at autumn.usefulapi.io, added by URL only. Sign-in is via OAuth; on first connect you paste your Autumn API key, which is validated and stored per user. No local install, no Authorization header in the client config.
Before you install
Several tools change billing data: creating or updating customers, creating entities, tracking usage (which deducts or credits balances), attaching plans (may create an invoice and return a payment URL) and opening a customer portal. Confirm before running them. Your Autumn API key is stored by the third-party host. The free tier allows 50 calls a month; paid plans cost $9/month or $90/year and up, billed through Stripe.

Installation

In SourceWeft

  1. Open Autumn MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fautumn/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "autumn-by-usefulapi": {
      "type": "http",
      "url": "https://autumn.usefulapi.io/mcp"
    }
  }
}

README

Autumn MCP by usefulapi

Read your Autumn customers, features, plans, balances and invoices — and create customers, track usage or attach plans — from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Autumn API key.

Live endpoint: https://autumn.usefulapi.io/mcp · Homepage: https://usefulapi.io/autumn

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://autumn.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http autumn https://autumn.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "autumn": {      "url": "https://autumn.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Autumn credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/autumn/

On first connect you'll paste your Autumn API key. It's validated, stored per-user, and scoped to you.

Tools

ToolTypeWhat it does
autumn_get_customerreadGet a customer
autumn_list_customersreadList customers
autumn_checkreadCheck feature access / balance
autumn_list_invoicesreadList invoices
autumn_get_entityreadGet an entity
autumn_list_entitiesreadList entities
autumn_list_featuresreadList features
autumn_get_featurereadGet a feature
autumn_list_plansreadList plans
autumn_get_planreadGet a plan
autumn_preview_attachreadPreview attaching a plan
autumn_requestreadRaw read request
autumn_get_or_create_customerwriteGet or create a customer
autumn_update_customerwriteUpdate a customer
autumn_track_usagewriteTrack usage
autumn_attach_planwriteAttach a plan
autumn_create_entitywriteCreate an entity
autumn_open_customer_portalwriteOpen customer billing portal
autumn_usage_statusmetaUsage status (free-tier meter)
autumn_request_featuremetaRequest a missing feature
autumn_upgrademetaUpgrade to Pro or Pro+
autumn_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with autumn_upgrade (it returns a Stripe Checkout link). Cancel any time with autumn_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running autumn_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/autumn/README.md at commit 4046075

Tools

18

autumn_get_customer

Get a customer

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

Parametersexpandcustomer_idrequired

autumn_list_customers

List customers

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

Parameterslimitplanssearchprocessorsstart_cursorsubscription_status

autumn_check

Check feature access / balance

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.

Parametersentity_idfeature_idrequiredcustomer_idrequiredwith_previewrequired_balance

autumn_list_invoices

List invoices

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

Parameterslimitstatusentity_idcustomer_idstart_cursorprocessor_types

autumn_get_entity

Get an entity

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

Parametersexpandentity_idrequiredcustomer_idrequired

autumn_list_entities

List entities

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

Parameterslimitplanssearchprocessorscustomer_idrequiredstart_cursorsubscription_status

autumn_list_features

List features

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

Takes no parameters.

autumn_get_feature

Get a feature

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

Parametersfeature_idrequired

autumn_list_plans

List plans

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

Parametersentity_idcustomer_idall_versionsinclude_archived

autumn_get_plan

Get a plan

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

Parametersplan_idrequiredversion

autumn_preview_attach

Preview attaching a plan

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.

Parametersplan_idrequiredversioncustomizeentity_idcustomer_idrequiredfeature_quantities

autumn_request

Raw read request

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}.

Parametersbodypathrequired

autumn_get_or_create_customer

Get or create a customer

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

Parametersnameemailexpandcurrencymetadatastripe_idcustomer_idrequiredfingerprintcreate_in_stripe

autumn_update_customer

Update a customer

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

Parametersnameemailcurrencymetadatastripe_idcustomer_idrequiredfingerprintnew_customer_id

autumn_track_usage

Track usage

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.

Parametersvalueentity_idtimestampevent_namefeature_idpropertiescustomer_idrequiredidempotencyKey

autumn_attach_plan

Attach a plan

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 }.

Parametersplan_idrequiredversioncustomizeentity_idcustomer_idrequiredsuccess_urlinvoice_moderedirect_modefeature_quantitiescheckout_session_params

autumn_create_entity

Create an entity

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

Parametersnameentity_idrequiredfeature_idrequiredcustomer_idrequiredbilling_controls

autumn_open_customer_portal

Open customer billing portal

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 }.

Parametersreturn_urlcustomer_idrequiredconfiguration_id

Version history

22
  1. v1.37.5LatestNov 8, 2026
  2. v1.37.4Nov 7, 2026
  3. v1.36.3Nov 5, 2026
  4. v1.36.2Nov 5, 2026
  5. v1.36.1Nov 4, 2026
  6. v1.36.0Nov 3, 2026
  7. v1.35.1Nov 3, 2026
  8. v1.34.0Nov 1, 2026
  9. v1.32.0Oct 31, 2026
  10. v1.31.0Oct 31, 2026
  11. v1.30.2Oct 30, 2026
  12. v1.30.0Oct 30, 2026
  13. v1.25.0Oct 26, 2026
  14. v1.22.3Oct 25, 2026
  15. v1.22.0Oct 25, 2026
  16. v1.21.0Oct 24, 2026
  17. v1.18.0Oct 23, 2026
  18. v1.16.4Oct 22, 2026
  19. v1.16.3Oct 21, 2026
  20. v1.11.1Oct 9, 2026
  21. v1.10.0Oct 9, 2026
  22. v1.0.1Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations