Servidor MCP del nodo de pagos de Dodo

Se genera con Acero Inoxidable .

Instalación

Invocación directa

Puede ejecutar el servidor MCP directamente a través de npx :

export DODO_PAYMENTS_API_KEY="My Bearer Token"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"
npx -y dodopayments-mcp@latest

A través del cliente MCP

Hay una lista parcial de clientes existentes en modelcontextprotocol.io . Si ya tiene un cliente, consulte su documentación para instalar el servidor MCP.

Para los clientes con un JSON de configuración, podría verse así:

{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp", "--client=claude", "--tools=dynamic"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "My Bearer Token",
        "DODO_PAYMENTS_ENVIRONMENT": "live_mode"
      }
    }
  }
}

Related MCP server: Lightning Enable MCP

Exposición de puntos finales a su cliente MCP

Hay dos formas de exponer puntos finales como herramientas en el servidor MCP:

1. Exponer una herramienta por punto final y filtrar según sea necesario

2. Exponer un conjunto de herramientas para descubrir e invocar dinámicamente puntos finales desde la API

Puntos finales y herramientas de filtrado

Puede ejecutar el paquete en la línea de comandos para descubrir y filtrar el conjunto de herramientas expuestas por el servidor MCP. Esto puede ser útil para API grandes donde incluir todos los endpoints a la vez resulta excesivo para la ventana de contexto de su IA.

Puedes filtrar por múltiples aspectos:

• --tool incluye una herramienta específica por nombre

• --resource incluye todas las herramientas bajo un recurso específico y puede tener comodines, por ejemplo, my.resource*

• --operation incluye solo operaciones de lectura (obtener/listar) o solo escritura

Herramientas dinámicas

Si especifica --tools=dynamic en el servidor MCP, en lugar de exponer una herramienta por punto final en la API, expondrá las siguientes herramientas:

1. list_api_endpoints : descubre los puntos finales disponibles, con filtrado opcional por consulta de búsqueda

2. get_api_endpoint_schema : obtiene información detallada del esquema para un punto final específico

3. invoke_api_endpoint - Ejecuta cualquier punto final con los parámetros apropiados

Esto le permite tener el conjunto completo de endpoints de API disponible para su cliente MCP, sin necesidad de cargar todos sus esquemas en contexto a la vez. En su lugar, LLM utilizará automáticamente estas herramientas para buscar, consultar e invocar endpoints dinámicamente. Sin embargo, debido a la naturaleza indirecta de los esquemas, puede resultar más difícil proporcionar las propiedades correctas que cuando las herramientas se importan explícitamente. Por lo tanto, puede optar por usar herramientas explícitas, dinámicas o ambas.

Vea más información con --help .

Todas estas opciones de línea de comandos se pueden repetir, combinar entre sí y tener versiones de exclusión correspondientes (por ejemplo --no-tool ).

Utilice --list para ver la lista de herramientas disponibles, o vea a continuación.

Especificación del cliente MCP

Los distintos clientes tienen distintas capacidades para manejar herramientas y esquemas arbitrarios.

Puede especificar el cliente que está utilizando con el argumento --client y el servidor MCP servirá automáticamente herramientas y esquemas que sean más compatibles con ese cliente.

• --client=<type> : Establece todas las capacidades en función de un cliente MCP conocido

  • Valores válidos: openai-agents , claude , claude-code , cursor

  • Ejemplo: --client=cursor

Además, si tiene un cliente que no está en la lista anterior, o el cliente ha mejorado con el tiempo, puede habilitar o deshabilitar manualmente ciertas capacidades:

• --capability=<name> : Especifica las capacidades individuales del cliente

  • Capacidades disponibles:

    • top-level-unions : habilita la compatibilidad con uniones de nivel superior en esquemas de herramientas

    • valid-json : Habilita el análisis de cadenas JSON para argumentos

    • refs : Habilita la compatibilidad con punteros $ref en esquemas

    • unions : habilita la compatibilidad con tipos de unión (anyOf) en esquemas

    • formats : habilita la compatibilidad con validaciones de formato en esquemas (por ejemplo, fecha y hora, correo electrónico)

    • tool-name-length=N : Establece la longitud máxima del nombre de la herramienta en N caracteres

  • Ejemplo: --capability=top-level-unions --capability=tool-name-length=40

  • Ejemplo: --capability=top-level-unions,tool-name-length=40

Ejemplos

1. Filtro para operaciones de lectura en tarjetas:

--resource=cards --operation=read

2. Excluir herramientas específicas mientras se incluyen otras:

--resource=cards --no-tool=create_cards

3. Configurar para el cliente Cursor con longitud máxima de nombre de herramienta personalizada:

--client=cursor --capability=tool-name-length=40

4. Filtrado complejo con múltiples criterios:

--resource=cards,accounts --operation=read --tag=kyc --no-tool=create_cards

Importar las herramientas y el servidor individualmente

// Import the server, generated endpoints, or the init function
import { server, endpoints, init } from "dodopayments-mcp/server";

// import a specific tool
import createPayments from "dodopayments-mcp/tools/payments/create-payments";

// initialize the server and all endpoints
init({ server, endpoints });

// manually start server
const transport = new StdioServerTransport();
await server.connect(transport);

// or initialize your own server with specific tools
const myServer = new McpServer(...);

// define your own endpoint
const myCustomEndpoint = {
  tool: {
    name: 'my_custom_tool',
    description: 'My custom tool',
    inputSchema: zodToJsonSchema(z.object({ a_property: z.string() })),
  },
  handler: async (client: client, args: any) => {
    return { myResponse: 'Hello world!' };
  })
};

// initialize the server with your custom endpoints
init({ server: myServer, endpoints: [createPayments, myCustomEndpoint] });

Herramientas disponibles

Las siguientes herramientas están disponibles en este servidor MCP.

payments recursos:

• create_payments ( write ):

• retrieve_payments ( read ):

• list_payments ( read ):

• retrieve_line_items_payments ( read ):

subscriptions a recursos:

• create_subscriptions ( write ):

• retrieve_subscriptions ( read ):

• update_subscriptions ( write ):

• list_subscriptions ( read ):

• change_plan_subscriptions ( write ):

• charge_subscriptions ( write ):

invoices.payments de recursos.Pagos:

• retrieve_invoices_payments ( read ):

licenses de recursos:

• activate_licenses ( write ):

• deactivate_licenses ( write ):

• validate_licenses ( write ):

license_keys de recurso:

• retrieve_license_keys ( read ):

• update_license_keys ( write ):

• list_license_keys ( read ):

license_key_instances de recurso:

• retrieve_license_key_instances ( read ):

• update_license_key_instances ( write ):

• list_license_key_instances ( read ):

customers de recursos:

• create_customers ( write ):

• retrieve_customers ( read ):

• update_customers ( write ):

• list_customers ( read ):

Recurso customers.customer_portal :

• create_customers_customer_portal ( write ):

refunds de recursos:

• create_refunds ( write ):

• retrieve_refunds ( read ):

• list_refunds ( read ):

disputes sobre recursos:

• retrieve_disputes ( read ):

• list_disputes ( read ):

payouts de recursos:

• list_payouts ( read ):

webhook_events de recursos:

• retrieve_webhook_events ( read ):

• list_webhook_events ( read ):

products de recursos:

• create_products ( write ):

• retrieve_products ( read ):

• update_products ( write ):

• list_products ( read ):

• delete_products ( write ):

• unarchive_products ( write ):

products.images de recursos.imágenes:

• update_products_images ( write ):

Recursos misc :

• list_supported_countries_misc ( read ):

discounts en recursos:

• create_discounts ( write ): si se omite code o está vacío, se genera un código aleatorio en mayúsculas de 16 caracteres.

• retrieve_discounts ( read ): OBTENER /descuentos/{id_descuento}

• update_discounts ( write ): PATCH /descuentos/{id_descuento}

• list_discounts ( read ): GET /descuentos

• delete_discounts ( write ): ELIMINAR /descuentos/{id_descuento}

addons de recursos:

• create_addons ( write ):

• retrieve_addons ( read ):

• update_addons ( write ):

• list_addons ( read ):

• update_images_addons ( write ):

brands de recursos:

• create_brands ( write ):

• retrieve_brands ( read ): el controlador delgado simplemente llama get_brand y lo envuelve en Json(...)

• update_brands ( write ):

• list_brands ( read ):

• update_images_brands ( write ):