Lunar Billing Interface for Autumn Services

This repository furnishes an unofficial external connector for interacting with the official Autumn platform billing infrastructure. It exposes a simplified layer over the native Autumn pricing API for managing subscriber data.

Functionality Matrix

[x] Customer record creation procedures
[x] Retrieval of client data via unique identifier
[x] Querying active service entitlements for a client
[x] Comprehensive invoice lifecycle management
[x] Provisioning of a secure payment portal link for end-users

Documentation & Schema

API Specification Access

The associated MCP agent incorporates the OpenAPI specification document from Autumn's backend, enabling introspection across the following endpoints:

[x] /attach
[x] /entitled
[x] /events
[x] /customers
[x] /customers/:id
[x] /customers/:id/billing_portal

Suggested AI Interactions

[x] Standardized AI Builder Prompting (Compatible with Bolt.new, v0, etc.)

Deployment and Execution Guide

Automated Deployment via Smithery

Installation of the Lunar Billing Interface agent into Claude Desktop environments is streamlined via the Smithery registry:

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

This package is also verified for integration with: Cursor, Windsurf, Witsy, Enconvo, Goose, and SpinAI.

Non-Smithery Installation (Manual Procedure)

While accessing the Smithery URL above is the simpler route, manual deployment is available for advanced users:

For Claude Environment:
Clone this source code repository.
Execute bun install within the cloned directory to resolve dependencies.
Determine the full absolute path to the primary entry file (index.ts).
Augment your configuration file (claude_desktop_config.json or equivalent) as follows:

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

For Other Compatible Applications:

Operation requires the Bun runtime to be installed locally. The execution command structure is: bash bun run {absolute path to index.ts} --apiKey="{your api key}"

Either the public credential or the secret token may be utilized, though reliance on the public key might restrict access to certain backend operations.