Сервер MCP узла Dodo Payments

Он создан с помощью Stainless .

Установка

Прямой вызов

Вы можете запустить MCP-сервер напрямую через npx :

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

Через MCP-клиент

Частичный список существующих клиентов находится на modelcontextprotocol.io . Если у вас уже есть клиент, обратитесь к его документации, чтобы установить сервер MCP.

Для клиентов с конфигурацией JSON это может выглядеть примерно так:

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

Предоставление конечных точек вашему клиенту MCP

Существует два способа предоставления конечных точек в качестве инструментов на сервере MCP:

1. Предоставление одного инструмента на конечную точку и фильтрация по мере необходимости

2. Предоставление набора инструментов для динамического обнаружения и вызова конечных точек из API

Фильтрация конечных точек и инструментов

Вы можете запустить пакет в командной строке, чтобы обнаружить и отфильтровать набор инструментов, предоставляемых сервером MCP. Это может быть полезно для больших API, где включение всех конечных точек одновременно слишком много для контекстного окна вашего ИИ.

Вы можете фильтровать по нескольким аспектам:

• --tool включает в себя определенный инструмент по имени

• --resource включает все инструменты определенного ресурса и может иметь подстановочные знаки, например my.resource*

• --operation включает только операции чтения (получения/перечисления) или только операции записи

Динамические инструменты

Если указать --tools=dynamic для сервера MCP, то вместо предоставления одного инструмента для каждой конечной точки в API будут предоставлены следующие инструменты:

1. list_api_endpoints — обнаруживает доступные конечные точки с возможностью фильтрации по поисковому запросу.

2. get_api_endpoint_schema — получает подробную информацию о схеме для определенной конечной точки

3. invoke_api_endpoint — выполняет любую конечную точку с соответствующими параметрами

Это позволяет вам иметь полный набор конечных точек API, доступных вашему клиенту MCP, не требуя при этом, чтобы все их схемы были загружены в контекст одновременно. Вместо этого LLM будет автоматически использовать эти инструменты вместе для поиска, просмотра и вызова конечных точек динамически. Однако из-за косвенной природы схем он может испытывать трудности с предоставлением правильных свойств немного больше, чем при явном импорте инструментов. Поэтому вы можете выбрать явные инструменты, динамические инструменты или и то, и другое.

Дополнительную информацию можно получить с помощью --help .

Все эти параметры командной строки можно повторять, комбинировать вместе и иметь соответствующие версии исключения (например, --no-tool ).

Используйте --list , чтобы просмотреть список доступных инструментов, или смотрите ниже.

Указание клиента MCP

Разные клиенты обладают разными возможностями работы с произвольными инструментами и схемами.

Вы можете указать используемый вами клиент с помощью аргумента --client , и сервер MCP автоматически предоставит инструменты и схемы, которые более совместимы с этим клиентом.

• --client=<type> : Установить все возможности на основе известного клиента MCP

  • Допустимые значения: openai-agents , claude , claude-code , cursor

  • Пример: --client=cursor

Кроме того, если у вас есть клиент, которого нет в списке выше, или клиент со временем стал лучше, вы можете вручную включить или отключить определенные возможности:

• --capability=<name> : Укажите индивидуальные возможности клиента

  • Доступные возможности:

    • top-level-unions : включить поддержку объединений верхнего уровня в схемах инструментов

    • valid-json : включить анализ строки JSON для аргументов

    • refs : включить поддержку указателей $ref в схемах

    • unions : включить поддержку типов объединений (anyOf) в схемах

    • formats : включить поддержку проверки форматов в схемах (например, дата-время, электронная почта)

    • tool-name-length=N : Установить максимальную длину имени инструмента в N символов

  • Пример: --capability=top-level-unions --capability=tool-name-length=40

  • Пример: --capability=top-level-unions,tool-name-length=40

Примеры

1. Фильтр по операциям чтения на картах:

--resource=cards --operation=read

2. Исключите определенные инструменты, включив другие:

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

3. Настройте для клиента Cursor максимальную длину имени инструмента:

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

4. Сложная фильтрация по нескольким критериям:

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

Импорт инструментов и сервера по отдельности

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

Доступные инструменты

На этом сервере MCP доступны следующие инструменты.

Ресурсные 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 ):

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 ):

Ресурс 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 ):

Ресурс 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 ):

Ресурс 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 ):

Ресурс products.images :

• update_products_images ( write ):

Ресурс misc :

• list_supported_countries_misc ( read ):

discounts на ресурсы:

• create_discounts ( write ): Если code пропущен или пуст, генерируется случайный 16-символьный заглавный код.

• retrieve_discounts ( read ): ПОЛУЧИТЬ /discounts/{discount_id}

• update_discounts ( write ): ПАТЧ /discounts/{discount_id}

• list_discounts ( read ): ПОЛУЧИТЬ /discounts

• delete_discounts ( write ): УДАЛИТЬ /discounts/{discount_id}

Ресурсные addons :

• create_addons ( write ):

• retrieve_addons ( read ):

• update_addons ( write ):

• list_addons ( read ):

• update_images_addons ( write ):

brands ресурсов:

• create_brands ( write ):

• retrieve_brands ( read ): Тонкий обработчик просто вызывает get_brand и оборачивает в Json(...)

• update_brands ( write ):

• list_brands ( read ):

• update_images_brands ( write ):