# Autumn MCP by usefulapi

> Autumn MCP by usefulapi is a freemium MCP server for finance and payments. Hosted MCP server letting AI clients read and manage Autumn billing data. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode, CLI
- **Website:** https://usefulapi.io/autumn/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/autumn
- **MCP Registry name:** io.usefulapi/autumn
- **Categories:** finance and payments
- **Listing updated:** 2026-11-18

## About

The README describes this as a hosted remote server, so there is nothing to install locally. You point Claude, ChatGPT, Cursor or another MCP client at its URL and sign in with your Autumn API key through an OAuth login page. From there the assistant can look up customers, plans, features, balances and invoices in your Autumn environment.

The server exposes 22 tools in total. Twelve are read-only, covering customer, entity, feature, plan, invoice and balance lookups, plus a preview of attaching a plan. Six can change billing data, such as creating or updating customers, tracking usage, attaching plans and opening a Stripe billing portal session. The remaining four are for the usefulapi account itself: checking usage against the free meter, upgrading or cancelling a Pro subscription, and sending feature requests.

It suits SaaS teams that bill customers through Autumn plans and want to answer billing questions in plain language. The site notes it is an independent usefulapi service, not an official Autumn product.

## Features

- **Read-only billing lookups:** Twelve read tools cover customers, entities, features, plans, invoices and balance checks without changing data.
- **Confirmable write tools:** Six tools can create or update customers, record usage, attach plans and open billing portal sessions, and clients typically ask for approval first.
- **Plan change preview:** A preview tool shows the cost and effect of attaching a plan before anything is charged.
- **OAuth sign-in:** Clients authenticate through a login page that asks for an Autumn API key, so no key goes into client config files.
- **Broad client support:** Setup steps are given for Claude, ChatGPT, Claude Code, Cursor, VS Code and Codex, plus any Streamable HTTP MCP client.

## Good for

- Check which customers have an active subscription and which plan each is on
- Confirm whether a customer still has enough credits for a feature before a task
- Compare plans and the features each one includes
- Summarise recently issued invoices and the customers they went to
- Preview a plan change for a customer before attaching it

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http autumn https://autumn.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://autumn.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "autumn": {
      "url": "https://autumn.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "autumn": {
      "type": "http",
      "url": "https://autumn.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "autumn": {
      "serverUrl": "https://autumn.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `autumn_get_customer`: Fetch a single Autumn customer by id, optionally expanding related data (invoices, entities, subscriptions, balances). Autumn API: POST /v1/customers.get.
- `autumn_list_customers`: List/filter customers with cursor pagination. Autumn API: POST /v1/customers.list. Returns { list, next_cursor }.
- `autumn_check`: 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.
- `autumn_list_invoices`: List invoices with cursor pagination and optional filters. Autumn API: POST /v1/invoices.list. Returns { list, next_cursor }.
- `autumn_get_entity`: Fetch a single entity (e.g. a seat) belonging to a customer. Autumn API: POST /v1/entities.get.
- `autumn_list_entities`: List a customer's entities with cursor pagination and optional filters. Autumn API: POST /v1/entities.list. Returns { list, next_cursor }.
- `autumn_list_features`: List all features in the current environment. Autumn API: POST /v1/features.list. Returns { list }.
- `autumn_get_feature`: Fetch a single feature by id. Autumn API: POST /v1/features.get.
- `autumn_list_plans`: List all plans (products) in the current environment. Autumn API: POST /v1/plans.list. Returns { list }.
- `autumn_get_plan`: Fetch a single plan by id (optionally a specific version). Autumn API: POST /v1/plans.get.
- `autumn_preview_attach`: 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.
- `autumn_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}.
- `autumn_get_or_create_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.
- `autumn_update_customer`: MUTATES Autumn billing data — partially updates a customer. Only provided fields change. Autumn API: POST /v1/customers.update.
- `autumn_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.
- `autumn_attach_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 }.
- `autumn_create_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.
- `autumn_open_customer_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 }.

## FAQ

### What do I need to connect?

The login page asks for your Autumn API key, which you can find in the Autumn dashboard under Developer, then API keys.

### Can the AI change my Autumn data?

Yes, through six tools that can create or change data. The other 12 are marked read-only, and most MCP clients ask you to approve a tool call before it runs.

### Is this an official Autumn product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Autumn.

### What does it cost?

The Free plan allows 50 tool calls a month. Pro is $9/mo or $90/yr for 10,000 calls, and Pro+ is $39/mo or $390/yr for 100,000 calls.

### Is Autumn MCP by usefulapi free?

Autumn MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Autumn MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http autumn https://autumn.usefulapi.io/mcp

### What are the best alternatives to Autumn MCP by usefulapi?

The closest alternatives to Autumn MCP by usefulapi are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 14 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/autumn-mcp-by-usefulapi
