# autumn MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-usefulapi-autumn
- Repository: https://github.com/m190/usefulapi-mcp

## Install
- Endpoint: https://autumn.usefulapi.io/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://autumn.usefulapi.io/mcp

## Tools
- 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. Endpoint: https://autumn.usefulapi.io/mcp
- list_customers (List customers) - List/filter customers with cursor pagination. Autumn API: POST /v1/customers.list. Returns { list, next_cursor }. Endpoint: https://autumn.usefulapi.io/mcp
- 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. Endpoint: https://autumn.usefulapi.io/mcp
- list_invoices (List invoices) - List invoices with cursor pagination and optional filters. Autumn API: POST /v1/invoices.list. Returns { list, next_cursor }. Endpoint: https://autumn.usefulapi.io/mcp
- get_entity (Get an entity) - Fetch a single entity (e.g. a seat) belonging to a customer. Autumn API: POST /v1/entities.get. Endpoint: https://autumn.usefulapi.io/mcp
- 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 }. Endpoint: https://autumn.usefulapi.io/mcp
- list_features (List features) - List all features in the current environment. Autumn API: POST /v1/features.list. Returns { list }. Endpoint: https://autumn.usefulapi.io/mcp
- get_feature (Get a feature) - Fetch a single feature by id. Autumn API: POST /v1/features.get. Endpoint: https://autumn.usefulapi.io/mcp
- list_plans (List plans) - List all plans (products) in the current environment. Autumn API: POST /v1/plans.list. Returns { list }. Endpoint: https://autumn.usefulapi.io/mcp
- get_plan (Get a plan) - Fetch a single plan by id (optionally a specific version). Autumn API: POST /v1/plans.get. Endpoint: https://autumn.usefulapi.io/mcp
- 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. Endpoint: https://autumn.usefulapi.io/mcp
- 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}. Endpoint: https://autumn.usefulapi.io/mcp
- 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. Endpoint: https://autumn.usefulapi.io/mcp
- update_customer (Update a customer) - MUTATES Autumn billing data — partially updates a customer. Only provided fields change. Autumn API: POST /v1/customers.update. Endpoint: https://autumn.usefulapi.io/mcp
- 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. Endpoint: https://autumn.usefulapi.io/mcp
- 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 }. Endpoint: https://autumn.usefulapi.io/mcp
- 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. Endpoint: https://autumn.usefulapi.io/mcp
- 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 }. Endpoint: https://autumn.usefulapi.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.usefulapi
- Version: 1.0.1
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 17, 2026
- Source: https://registry.modelcontextprotocol.io