MCP 服务器

autumn

io.usefulapi/autumn
商业与运营 支付与金融科技 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Manages Autumn billing data including customers, plans, features, balances, invoices, usage, subscriptions, and billing portal sessions.

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 }.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id', 'plan_id'], 'properties': {'plan_id': {'type': 'string', 'description': 'The ID of the plan.'}, 'version': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The version of the plan to attach.'}, 'customize': {'type': 'object', 'description': 'Optional plan overrides (price, items, licenses, free trial).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'entity_id': {'type': 'string', 'description': 'The ID of the entity to attach the plan to.'}, 'customer_id': {'type': 'string', 'description': 'The ID of the customer to attach the plan to.'}, 'success_url': {'type': 'string', 'description': 'URL to redirect to after a successful checkout.'}, 'invoice_mode': {'type': 'object', 'description': 'Invoice-mode configuration object (send an invoice instead of auto-charging).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'redirect_mode': {'type': 'string', 'description': 'Checkout redirect mode: always, if_required, or never.'}, 'feature_quantities': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'description': 'Prepaid feature quantities: array of { feature_id, quantity?, adjustable? }.'}, 'checkout_session_params': {'type': 'object', 'description': 'Extra Stripe checkout session params (can carry metadata).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
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}.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['path'], 'properties': {'body': {'type': 'object', 'description': "JSON body object to POST (the endpoint's params).", 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'path': {'type': 'string', 'description': 'Full API path, e.g. "/v1/customers.get". Only read/preview suffixes are allowed.'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id', 'feature_id'], 'properties': {'entity_id': {'type': 'string', 'description': 'Entity id for entity-scoped balances (e.g. per-seat limits).'}, 'feature_id': {'type': 'string', 'description': 'The ID of the feature to check.'}, 'customer_id': {'type': 'string', 'description': 'The ID of the customer.'}, 'with_preview': {'type': 'boolean', 'description': 'Include upgrade/upsell (paywall) info in the response when access is denied.'}, 'required_balance': {'type': 'number', 'description': 'Minimum balance required for access. Returns allowed:false if below. Defaults to 1.'}}}
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.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id', 'entity_id', 'feature_id'], 'properties': {'name': {'type': ['string', 'null'], 'description': 'The name of the entity.'}, 'entity_id': {'type': 'string', 'description': 'The ID of the entity.'}, 'feature_id': {'type': 'string', 'description': 'The ID of the feature this entity is associated with.'}, 'customer_id': {'type': 'string', 'description': 'The ID of the customer to create the entity for.'}, 'billing_controls': {'type': 'object', 'description': 'Optional billing controls for the entity (spend/usage limits).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id'], 'properties': {'expand': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Related data to expand, e.g. invoices, entities, subscriptions.plan, purchases.plan, balances.feature.'}, 'customer_id': {'type': 'string', 'description': 'Your unique identifier for the customer.'}}}
get_entity
Get an entity
Fetch a single entity (e.g. a seat) belonging to a customer. Autumn API: POST /v1/entities.get.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id', 'entity_id'], 'properties': {'expand': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Related data to expand, e.g. invoices, entities, subscriptions.plan, purchases.plan, balances.feature.'}, 'entity_id': {'type': 'string', 'description': 'The ID of the entity.'}, 'customer_id': {'type': 'string', 'description': 'The ID of the customer that owns the entity.'}}}
get_feature
Get a feature
Fetch a single feature by id. Autumn API: POST /v1/features.get.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['feature_id'], 'properties': {'feature_id': {'type': 'string', 'description': 'The ID of the feature.'}}}
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.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id'], 'properties': {'name': {'type': 'string', 'description': "Customer's name."}, 'email': {'type': 'string', 'description': "Customer's email address."}, 'expand': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Related data to expand, e.g. invoices, entities, subscriptions.plan, purchases.plan, balances.feature.'}, 'currency': {'type': 'string', 'description': 'Currency to bill this customer in (e.g. usd, eur).'}, 'metadata': {'type': 'object', 'description': 'Arbitrary key/value metadata for the customer.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'stripe_id': {'type': 'string', 'description': 'Existing Stripe customer id, if any.'}, 'customer_id': {'type': ['string', 'null'], 'description': 'Your unique identifier for the customer (null to create an anonymous customer).'}, 'fingerprint': {'type': 'string', 'description': 'Unique identifier to detect duplicate customers / prevent free-trial abuse.'}, 'create_in_stripe': {'type': 'boolean', 'description': 'Whether to create the customer in Stripe.'}}}
get_plan
Get a plan
Fetch a single plan by id (optionally a specific version). Autumn API: POST /v1/plans.get.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['plan_id'], 'properties': {'plan_id': {'type': 'string', 'description': 'The ID of the plan to retrieve.'}, 'version': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The plan version to get. Defaults to the latest.'}}}
list_customers
List customers
List/filter customers with cursor pagination. Autumn API: POST /v1/customers.list. Returns { list, next_cursor }.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 5000, 'minimum': 1, 'description': 'Page size, 1-5000. Default 50.'}, 'plans': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'description': 'Filter by plan: array of { id, versions? } objects.'}, 'search': {'type': 'string', 'description': 'Search customers by id, name, or email.'}, 'processors': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter by processor type: stripe, revenuecat, vercel.'}, 'start_cursor': {'type': 'string', 'description': "Pagination cursor from a prior response's `next_cursor` (omit / empty for first page)."}, 'subscription_status': {'type': 'string', 'description': 'Filter by status: "active" or "scheduled". Defaults to both.'}}}
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 }.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 5000, 'minimum': 1, 'description': 'Page size, 1-5000. Default 50.'}, 'plans': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'description': 'Filter by plan: array of { id, versions? } objects.'}, 'search': {'type': 'string', 'description': 'Search entities by id or name.'}, 'processors': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter by parent customer processor: stripe, revenuecat, vercel.'}, 'customer_id': {'type': 'string', 'description': 'Restrict the response to entities owned by this customer id.'}, 'start_cursor': {'type': 'string', 'description': "Pagination cursor from a prior response's `next_cursor` (omit / empty for first page)."}, 'subscription_status': {'type': 'string', 'description': 'Filter by status: "active" or "scheduled". Defaults to both.'}}}
list_features
List features
List all features in the current environment. Autumn API: POST /v1/features.list. Returns { list }.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_invoices
List invoices
List invoices with cursor pagination and optional filters. Autumn API: POST /v1/invoices.list. Returns { list, next_cursor }.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 5000, 'minimum': 1, 'description': 'Page size, 1-5000. Default 50.'}, 'status': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter by invoice status: draft, open, paid, void, uncollectible.'}, 'entity_id': {'type': 'string', 'description': 'Filter to a single entity by id (must be paired with customer_id).'}, 'customer_id': {'type': 'string', 'description': 'Filter to a single customer by id.'}, 'start_cursor': {'type': 'string', 'description': "Pagination cursor from a prior response's `next_cursor` (omit / empty for first page)."}, 'processor_types': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter by processor: stripe, revenuecat.'}}}
list_plans
List plans
List all plans (products) in the current environment. Autumn API: POST /v1/plans.list. Returns { list }.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'entity_id': {'type': 'string', 'description': 'Entity id for entity-scoped plans.'}, 'customer_id': {'type': 'string', 'description': 'Include eligibility info (trial availability, attach scenario) for this customer.'}, 'all_versions': {'type': 'boolean', 'description': 'If true, include all plan versions.'}, 'include_archived': {'type': 'boolean', 'description': 'If true, include archived plans.'}}}
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 }.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id'], 'properties': {'return_url': {'type': 'string', 'description': 'URL to redirect to when the back button is clicked in the portal.'}, 'customer_id': {'type': 'string', 'description': 'The ID of the customer to open the billing portal for.'}, 'configuration_id': {'type': 'string', 'description': 'Stripe billing-portal configuration id.'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id', 'plan_id'], 'properties': {'plan_id': {'type': 'string', 'description': 'The ID of the plan.'}, 'version': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The version of the plan to attach.'}, 'customize': {'type': 'object', 'description': 'Optional plan overrides (price, items, licenses, free trial).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'entity_id': {'type': 'string', 'description': 'The ID of the entity to attach the plan to.'}, 'customer_id': {'type': 'string', 'description': 'The ID of the customer to attach the plan to.'}, 'feature_quantities': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'description': 'Prepaid feature quantities: array of { feature_id, quantity?, adjustable? }.'}}}
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.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id'], 'properties': {'value': {'type': 'number', 'description': 'Amount of usage to record. Defaults to 1. Negative values credit the balance.'}, 'entity_id': {'type': 'string', 'description': 'Entity id for entity-scoped balances.'}, 'timestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Unix timestamp (ms) for the event. Defaults to now.'}, 'event_name': {'type': 'string', 'description': 'Event name to track usage for. Provide this OR feature_id.'}, 'feature_id': {'type': 'string', 'description': 'The feature to track usage for. Provide this OR event_name.'}, 'properties': {'type': 'object', 'description': 'Additional properties to attach to the usage event.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'customer_id': {'type': 'string', 'description': 'The ID of the customer.'}, 'idempotencyKey': {'type': 'string', 'description': 'Optional key to dedupe retried events.'}}}
update_customer
Update a customer
MUTATES Autumn billing data — partially updates a customer. Only provided fields change. Autumn API: POST /v1/customers.update.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id'], 'properties': {'name': {'type': ['string', 'null'], 'description': "Customer's name."}, 'email': {'type': ['string', 'null'], 'description': "Customer's email address."}, 'currency': {'type': ['string', 'null'], 'description': 'Currency to bill this customer in (e.g. usd, eur).'}, 'metadata': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}], 'description': 'Arbitrary key/value metadata for the customer.'}, 'stripe_id': {'type': ['string', 'null'], 'description': 'Stripe customer id.'}, 'customer_id': {'type': 'string', 'description': 'ID of the customer to update.'}, 'fingerprint': {'type': ['string', 'null'], 'description': 'Duplicate-detection fingerprint.'}, 'new_customer_id': {'type': 'string', 'description': 'New id for the customer.'}}}
已更改
open_customer_portal
2026年10月1日 02:50
已更改
create_entity
2026年10月1日 02:50
已更改
attach_plan
2026年10月1日 02:50
已更改
track_usage
2026年10月1日 02:50
已更改
update_customer
2026年10月1日 02:50
已更改
get_or_create_customer
2026年10月1日 02:50
已更改
autumn_request
2026年10月1日 02:50
已更改
preview_attach
2026年10月1日 02:50
已更改
get_plan
2026年10月1日 02:50
已更改
list_plans
2026年10月1日 02:50
已更改
get_feature
2026年10月1日 02:50
已更改
list_features
2026年10月1日 02:50
已更改
list_entities
2026年10月1日 02:50
已更改
get_entity
2026年10月1日 02:50
已更改
list_invoices
2026年10月1日 02:50
已更改
check
2026年10月1日 02:50
已更改
list_customers
2026年10月1日 02:50
已更改
get_customer
2026年10月1日 02:50
已添加
open_customer_portal
2026年9月17日 12:53
已添加
create_entity
2026年9月17日 12:53
已添加
attach_plan
2026年9月17日 12:53
已添加
track_usage
2026年9月17日 12:53
已添加
update_customer
2026年9月17日 12:53
已添加
get_or_create_customer
2026年9月17日 12:53
已添加
autumn_request
2026年9月17日 12:53
已添加
preview_attach
2026年9月17日 12:53
已添加
get_plan
2026年9月17日 12:53
已添加
list_plans
2026年9月17日 12:53
已添加
get_feature
2026年9月17日 12:53
已添加
list_features
2026年9月17日 12:53