autumn

Autumn MCP Server provides a convenient interface to Autumn's pricing and customer APIs via an MCP server. It exposes tools to create customers, fetch customers by ID, retrieve entitlements, manage invoices, and generate billing portal links. To use the server, supply your Autumn API key (via the apiKey flag or environment variable) and run the server through a compatible runtime (the project can be accessed via npm/npx or Bun, depending on your setup). Once running, you can query the exposed MCP endpoints through your AI apps or client configuration, enabling streamlined interactions with Autumn’s API from your workflows.

Prerequisites:

• Node.js and npm (or pnpm/yarn) installed on your system
• Optional: Bun installed if you plan to run via Bun as shown in the docs

Installation and setup steps:

1. Install the MCP server package via Smithery (recommended for automatic setups):

   npx -y @smithery/cli install @SirTenzin/autumn-mcp-server --client claude
   

   This integration supports Claude and other Smithery-supported clients.

2. Manual installation without Smithery (requires Bun for runtime in the provided example): Claude usage:

   • Clone the repository:

     git clone <repository-url>
     

   • Install dependencies with Bun:

     bun install
     

   • Use the absolute path to index.ts when configuring Claude:

     {
       "mcpServers": {
         "autumn": {
           "command": "bun",
           "args": [
             "run",
             "{YOUR ABSOLUTE PATH TO index.ts}",
             "--apiKey=\"{YOUR API KEY}\""
           ]
         }
       }
     }
     

   Other apps can run similarly if Bun is installed:

   bun run {absolute path to index.ts} --apiKey="{your api key}"
   

   You may use either public or secret keys; some features may be restricted with the public key.

Note: If you prefer npm-based execution, you can also run the MCP server directly via npx as shown in step 1. Ensure your environment variables (see below) are set accordingly.

Environment variables and config tips:

• Set AUTUMN_API_KEY (or API_KEY) with your Autumn access key to enable API calls from the MCP server.
• If using Smithery, the CLI will manage client installations and provide pre-configured commands for common AI apps such as Claude, Cursor, Windsurf, Witsy, Enconvo, Goose, and SpinAI.
• Some features may require a secret key instead of a public key; choose accordingly based on the API access you have.
• If you encounter networking or authentication errors, verify that the API key is correctly passed to the server (via env vars or the --apiKey flag) and that you are using a compatible runtime version (Node.js with npm, Bun, etc.).