Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.solvapay.com/llms.txt

Use this file to discover all available pages before exploring further.

MCP Pay is SolvaPay’s hosted MCP auth and monetization solution. Use MCP Pay when you want SolvaPay to run auth, billing, checkout, and paywall enforcement for your MCP server.

​
Product-first model

Every monetized offering starts as a Product. By default, new products are immediately:
  • Available for SDK Integration
  • Active in SolvaPay MCP Distribution
You can optionally enable Hosted MCP Pay when you want SolvaPay to run managed auth, identity, billing, and payment for your MCP server.

​
When to use MCP Pay

​
Hosted MCP Pay product (no-code managed MCP)

Use this when you want to connect an origin MCP server URL and let SolvaPay host authentication, authorization, billing pages, and paywall enforcement via a managed proxy endpoint.

​
How MCP Pay works

When Hosted MCP Pay is enabled, SolvaPay acts as a reverse proxy between MCP clients and your origin MCP server.
  • Authentication - OAuth 2.0 with Google and GitHub sign-in
  • Authorization - Purchase-plan checks per tool
  • Usage Tracking - Every tool call is automatically recorded as a meter event against a tool:{toolName} meter. Quota enforcement uses real-time meter aggregation.
  • Billing - Hosted checkout and billing flows with support for recurring, usage-based, hybrid, and one-time plans
  • Dynamic Client Registration - MCP clients can auto-register OAuth clients

​
Terminology

TermMeaning
ProductThe core entity in SolvaPay used for monetization and plan assignment
Origin MCP server URLYour actual MCP endpoint that SolvaPay proxies to
Signup default planThe plan automatically assigned to new users
Server default planThe default plan used for tool access in Hosted MCP Pay unless overridden
Hosted MCP PayOptional managed mode for auth, identity, billing, and payment
MeterA metric definition that tracks usage (e.g. tool:search_documents). Auto-created for each discovered MCP tool.
Meter eventA timestamped data point recorded each time a tool is called. Powers quota enforcement and billing.

​
Tool-to-plan mapping semantics

Hosted MCP access uses a clear precedence model:
  • noPlan: true on a tool means the tool is public
  • otherwise, access is allowed when the customer’s purchase plan matches:
    • the tool’s planIds, or
    • the MCP server defaultPlanRef
This means defaultPlanRef is always an additional fallback allowlist for protected tools.

​
Plan activation policy

When a customer calls activate_plan / POST /v1/sdk/activate, the response depends on the plan type:
  • Free — activated immediately.
  • Usage-based (PAYG) — activated eagerly at zero balance. The customer can call protected tools immediately and pay per use. Top-up is a separate step via topup / createTopupPaymentIntent and does not block activation.
  • Recurring / hybrid — returns topup_required or payment_required when the customer has no credit balance and no card on file. Route them to checkout before granting access.
The MCP App surface exposes this policy directly: the agent can call activate_plan and expect the paywall to clear for usage-based plans, with the topup intent handled asynchronously. For API-first setup, the POST /v1/sdk/products/mcp/bootstrap endpoint lets you define:
  • product
  • plans (free and paid in one array)
  • origin URL
  • tool mapping in one request
After bootstrap, use PUT /v1/sdk/products/:productRef/mcp/plans to replace plans and remap tool access without recreating the product. See Create a Hosted MCP Pay Product for request modes and examples.

​
Next steps