Quickstart: Providers

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { withPayments } from '@payo/mcp';

// Create your MCP server as usual
const server = new McpServer({
  name: 'weather-api',
  version: '1.0.0'
});

// Wrap with payments
const paidServer = withPayments(server, {
  apiKey: process.env.PAYO_API_KEY,
  pricing: {
    'get_weather': 0.01,      // $0.01 per call
    'get_forecast': 0.05,     // $0.05 per call
    'get_location': 0,        // Free
  }
});

// Register tools as normal
paidServer.tool('get_weather', {
  description: 'Get current weather for a city',
  inputSchema: {
    type: 'object',
    properties: {
      city: { type: 'string' }
    },
    required: ['city']
  }
}, async ({ city }) => {
  // Your tool implementation
  return { temperature: 72, conditions: 'sunny' };
});

// Start the server
paidServer.connect(transport);

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { withPayments } from '@payo/mcp';

const server = new McpServer({
  name: 'weather-api',
  version: '1.0.0'
});

const paidServer = withPayments(server, {
  apiKey: process.env.PAYO_API_KEY!,
  pricing: {
    'get_weather': 0.01,
    'get_forecast': 0.05,
    'get_alerts': 0.02,
    'list_cities': 0,  // Free discovery tool
  },
  providerName: 'WeatherAPI',  // Shown in error messages
  errorVerbosity: 'detailed',  // Helpful errors for agents
});

// Free tool - no payment required
paidServer.tool('list_cities', {
  description: 'List supported cities (free)',
}, async () => {
  return ['New York', 'Los Angeles', 'Chicago', 'Houston'];
});

// Paid tools
paidServer.tool('get_weather', {
  description: 'Get current weather ($0.01)',
  inputSchema: {
    type: 'object',
    properties: { city: { type: 'string' } },
    required: ['city']
  }
}, async ({ city }) => {
  return { city, temp: 72, conditions: 'sunny' };
});

paidServer.tool('get_forecast', {
  description: 'Get 7-day forecast ($0.05)',
  inputSchema: {
    type: 'object',
    properties: { city: { type: 'string' } },
    required: ['city']
  }
}, async ({ city }) => {
  return { city, forecast: ['sunny', 'cloudy', 'rain', 'sunny', 'sunny', 'cloudy', 'sunny'] };
});

// Connect via stdio
const transport = new StdioServerTransport();
paidServer.connect(transport);