MCP Pay Quick Start

This guide walks you through setting up your first monetized MCP server using MCP Pay. By the end, you'll have a proxy URL that users can add to their MCP clients.

Prerequisites

Before you begin, ensure you have:

• A SolvaPay account (create one here)
• An existing MCP server accessible via HTTPS
• At least one subscription plan created in the console

Step 1: Navigate to MCP Pay

Access MCP Pay from the sidebar in your provider dashboard.

Step 2: Create a New MCP Server

Click + New MCP server to open the creation form.

Step 3: Configure Server Details

Fill in the required information:

Field	Description	Required
Name	A unique display name for your MCP server	Yes
Origin MCP server URL	The HTTPS endpoint of your actual MCP server	Yes
API Key	Credential for authenticating with your origin server	No
Signup default plan	The free plan new users are auto-assigned	Yes

Origin URL

Enter the full URL to your MCP server endpoint. For example:

• https://mcp.yourdomain.com/mcp
• https://api.yourdomain.com/v1/mcp

The URL must be accessible over HTTPS.

API Key (Optional)

If your origin MCP server requires authentication, enter the API key here. This key is:

• Encrypted at rest
• Never exposed to end users
• Used only when SolvaPay forwards requests to your origin server

Default Plan

Select the plan that new users are automatically assigned when they first connect. This is typically a free tier with limited access or quotas.

Step 4: Discover Tools

Click Discover tools to fetch the available tools from your origin MCP server.

SolvaPay will:

1. Connect to your origin URL
2. Retrieve the list of available tools
3. Display them for plan assignment

If discovery fails, verify:

• The origin URL is correct and accessible
• Any required API key is provided
• Your origin server is responding to MCP protocol requests

Step 5: Assign Plans to Tools

For each discovered tool, configure access:

Default Plan Badge

The default plan you selected is automatically assigned to all tools (shown as a badge). Users on the free tier can access these tools.

Add Additional Plans

Select additional plans from the dropdown to grant access to paid subscribers. A tool can be accessible to multiple plans.

No Plan Option

Select No plan if the tool should be:

• Freely accessible to everyone (no authentication required)
• Not tracked for usage

Use "No plan" for utility tools that don't need monetization.

Step 6: Save and Get Your Proxy URL

Click Save server to create the MCP server configuration.

After saving, SolvaPay generates a proxy URL that looks like:

https://mcp.solvapay.com/p/{server-id}

This is the URL you share with your users.

User Onboarding Flow

When a user adds your MCP server to their client:

1. Add Server - User pastes the proxy URL into their MCP client (e.g., Cursor settings)
2. Authenticate - OAuth flow opens a browser window for Google/GitHub sign-in
3. Auto-Subscribe - New users are automatically assigned your default (free) plan
4. Use Tools - Each tool call is authorized against their subscription plan

Example: Adding to Cursor

Users add your server to their Cursor MCP configuration:

{
  "mcpServers": {
    "your-server-name": {
      "url": "https://mcp.solvapay.com/p/{server-id}"
    }
  }
}

When they first use a tool, Cursor opens a browser for authentication.

Testing Your Setup

1. Add your proxy URL to an MCP client
2. Trigger the authentication flow
3. Call a protected tool
4. Verify the call succeeds and appears in your dashboard

Managing Your MCP Server

After creation, you can:

• Edit configuration - Update name, origin URL, or API key
• Modify tool access - Change plan assignments
• View usage - See tool invocation statistics
• Disable/enable - Temporarily disable the proxy

Access these options from the MCP Pay server list by clicking on your server.

Next Steps

• Authentication - Learn about OAuth flows and Dynamic Client Registration
• Hosted Pages - Configure checkout and customer portal branding
• Best Practices - Plan configuration and quota strategies