Dodo Payments Node MCP-Server

Es wird mit Edelstahl erzeugt.

Installation

Direkter Aufruf

Sie können den MCP-Server direkt über npx ausführen:

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

Über den MCP-Client

Eine unvollständige Liste vorhandener Clients finden Sie unter modelcontextprotocol.io . Wenn Sie bereits einen Client besitzen, lesen Sie die Dokumentation zur Installation des MCP-Servers.

Für Clients mit einer JSON-Konfiguration könnte es etwa so aussehen:

{
  "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

Offenlegen von Endpunkten für Ihren MCP-Client

Es gibt zwei Möglichkeiten, Endpunkte als Tools im MCP-Server verfügbar zu machen:

1. Bereitstellung eines Tools pro Endpunkt und Filterung nach Bedarf

2. Bereitstellung einer Reihe von Tools zum dynamischen Erkennen und Aufrufen von Endpunkten über die API

Filtern von Endpunkten und Tools

Sie können das Paket in der Befehlszeile ausführen, um die vom MCP-Server bereitgestellten Tools zu ermitteln und zu filtern. Dies kann bei großen APIs hilfreich sein, bei denen die gleichzeitige Einbindung aller Endpunkte das Kontextfenster Ihrer KI überfordert.

Sie können nach mehreren Aspekten filtern:

• --tool schließt ein bestimmtes Werkzeug mit Namen ein

• --resource schließt alle Tools unter einer bestimmten Ressource ein und kann Platzhalter enthalten, z. B. my.resource*

• --operation umfasst nur Lese- (Get/List) oder nur Schreibvorgänge

Dynamische Werkzeuge

Wenn Sie --tools=dynamic für den MCP-Server angeben, werden in der API nicht ein Tool pro Endpunkt, sondern die folgenden Tools bereitgestellt:

1. list_api_endpoints - Ermittelt verfügbare Endpunkte, mit optionaler Filterung nach Suchanfrage

2. get_api_endpoint_schema - Ruft detaillierte Schemainformationen für einen bestimmten Endpunkt ab

3. invoke_api_endpoint - Führt jeden Endpunkt mit den entsprechenden Parametern aus

Dadurch steht Ihrem MCP-Client der gesamte Satz an API-Endpunkten zur Verfügung, ohne dass alle Schemata gleichzeitig in den Kontext geladen werden müssen. Stattdessen nutzt das LLM diese Tools automatisch gemeinsam, um Endpunkte dynamisch zu suchen, zu ermitteln und aufzurufen. Aufgrund der indirekten Natur der Schemata kann es jedoch schwieriger sein, die richtigen Eigenschaften bereitzustellen, als wenn die Tools explizit importiert werden. Daher können Sie explizite, dynamische oder beide Tools verwenden.

Weitere Informationen erhalten Sie mit --help .

Alle diese Befehlszeilenoptionen können wiederholt oder kombiniert werden und über entsprechende Ausschlussversionen verfügen (z. B. --no-tool ).

Verwenden Sie --list , um die Liste der verfügbaren Tools anzuzeigen, oder sehen Sie unten nach.

Festlegen des MCP-Clients

Verschiedene Clients verfügen über unterschiedliche Fähigkeiten, beliebige Tools und Schemata zu verarbeiten.

Sie können den von Ihnen verwendeten Client mit dem Argument --client angeben, und der MCP-Server stellt automatisch Tools und Schemas bereit, die mit diesem Client besser kompatibel sind.

• --client=<type> : Alle Funktionen basierend auf einem bekannten MCP-Client festlegen

  • Gültige Werte: openai-agents , claude , claude-code , cursor

  • Beispiel: --client=cursor

Wenn Sie einen Client haben, der nicht in der obigen Liste aufgeführt ist, oder wenn der Client mit der Zeit besser geworden ist, können Sie bestimmte Funktionen manuell aktivieren oder deaktivieren:

• --capability=<name> : Geben Sie individuelle Client-Fähigkeiten an

  • Verfügbare Funktionen:

    • top-level-unions : Aktivieren Sie die Unterstützung für Top-Level-Unions in Tool-Schemas

    • valid-json : Aktivieren Sie die JSON-String-Analyse für Argumente

    • refs : Aktivieren Sie die Unterstützung für $ref-Zeiger in Schemata

    • unions : Aktivieren Sie die Unterstützung für Union-Typen (anyOf) in Schemata

    • formats : Aktivieren Sie die Unterstützung für Formatvalidierungen in Schemata (z. B. Datum/Uhrzeit, E-Mail).

    • tool-name-length=N : Maximale Länge des Werkzeugnamens auf N Zeichen festlegen

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

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

Beispiele

1. Filter für Lesevorgänge auf Karten:

--resource=cards --operation=read

2. Schließen Sie bestimmte Tools aus, während Sie andere einschließen:

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

3. Konfigurieren Sie für den Cursor-Client mit benutzerdefinierter maximaler Länge des Toolnamens:

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

4. Komplexe Filterung mit mehreren Kriterien:

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

Importieren der Tools und Server einzeln

// 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] });

Verfügbare Tools

Die folgenden Tools sind auf diesem MCP-Server verfügbar.

payments :

• create_payments ( write ):

• retrieve_payments ( read ):

• list_payments ( read ):

• retrieve_line_items_payments ( read ):

subscriptions :

• create_subscriptions ( write ):

• retrieve_subscriptions ( read ):

• update_subscriptions ( write ):

• list_subscriptions ( read ):

• change_plan_subscriptions ( write ):

• charge_subscriptions ( write ):

Ressource invoices.payments :

• retrieve_invoices_payments ( read ):

licenses :

• activate_licenses ( write ):

• deactivate_licenses ( write ):

• validate_licenses ( write ):

license_keys :

• retrieve_license_keys ( read ):

• update_license_keys ( write ):

• list_license_keys ( read ):

Ressourcen license_key_instances :

• retrieve_license_key_instances ( read ):

• update_license_key_instances ( write ):

• list_license_key_instances ( read ):

customers :

• create_customers ( write ):

• retrieve_customers ( read ):

• update_customers ( write ):

• list_customers ( read ):

Ressource customers.customer_portal :

• create_customers_customer_portal ( write ):

refunds :

• create_refunds ( write ):

• retrieve_refunds ( read ):

• list_refunds ( read ):

disputes :

• retrieve_disputes ( read ):

• list_disputes ( read ):

payouts :

• list_payouts ( read ):

Ressource webhook_events :

• retrieve_webhook_events ( read ):

• list_webhook_events ( read ):

products :

• create_products ( write ):

• retrieve_products ( read ):

• update_products ( write ):

• list_products ( read ):

• delete_products ( write ):

• unarchive_products ( write ):

Ressource products.images :

• update_products_images ( write ):

misc Ressourcen:

• list_supported_countries_misc ( read ):

discounts :

• create_discounts ( write ): Wenn code weggelassen wird oder leer ist, wird ein zufälliger 16-stelliger Code in Großbuchstaben generiert.

• retrieve_discounts ( read ): GET /discounts/{discount_id}

• update_discounts ( write ): PATCH /discounts/{discount_id}

• list_discounts ( read ): GET /discounts

• delete_discounts ( write ): DELETE /discounts/{discount_id}

Ressourcen addons :

• create_addons ( write ):

• retrieve_addons ( read ):

• update_addons ( write ):

• list_addons ( read ):

• update_images_addons ( write ):

brands :

• create_brands ( write ):

• retrieve_brands ( read ): Der Thin-Handler ruft einfach get_brand auf und umschließt es in Json(...)

• update_brands ( write ):

• list_brands ( read ):

• update_images_brands ( write ):