Autumn Billing Gateway Adapter

This repository houses an unofficial intermediary service layer connecting to the Autumn Financial Platform. It exposes critical functionalities for maintaining customer records and managing their service access rights via the Autumn API.

Core Capabilities

[x] Provisioning new client profiles
[x] Retrieval of client records by unique identifier
[x] Querying active service entitlements for a client
[x] Administrative handling of client billing statements
[x] Secure generation of direct links to the self-service payment portal

Technical Specification

API Schema Access

The adapter maintains runtime cognizance of the underlying Autumn API structure via its OpenAPI specification, enabling interaction across these endpoints:

[x] /attach (Artifact linking)
[x] /entitled (Entitlement checks)
[x] /events (Activity logging)
[x] /customers (Client directory operations)
[x] /customers/:id (Specific client profile access)
[x] /customers/:id/billing_portal (Portal link generation endpoint)

Example Use Cases

[x] Prompting LLMs (e.g., Bolt.new, Lovable, v0) for complex subscription modifications.

Deployment Instructions

Automated Deployment via Smithery

For immediate integration into Claude Desktop environments utilizing Smithery:

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

This package is compatible with: Cursor, Windsurf, Witsy, Enconvo, Goose, and SpinAI.

Non-Smithery Manual Integration

While using the Smithery link above is recommended for streamlined setup, manual configuration requires prerequisite steps:

For Claude Desktop:
Obtain a local copy of the source repository via git clone.
Execute dependency resolution using bun install within the project directory.
Determine the absolute filesystem path pointing to index.ts.
Integrate the service configuration into your AI application's configuration file (e.g., claude_desktop_config.json):

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

For Other Supporting Environments:

This server necessitates the installation of the Bun runtime. The command structure for manual execution in environments supporting direct command invocation is: bash bun run {absolute path to index.ts} --apiKey="{your api key}"

Note: Both public and secret API keys may be employed; however, certain advanced functionalities might be restricted when using the public credential set.