# Digital Manager Guru — MCP server on mcp.ai
> Digital Manager Guru checkout and sales-management platform for digital products via the official API: sales/transactions, subscriptions, products and offers, contacts, affiliations, coupons, e-tickets and webhooks. Generate your User Token in the dashboard under My Profile → API Tokens.

By: mcp.ai · official
Page: https://mcp.ai/guru

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_guru?ms=1781638380000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/guru/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/guru/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/guru/skill.md
Postman collection (v2.1): https://mcp.ai/guru/postman.json

## Tools
- guru_account(account_token: string, account?: string) — Valida um Account Token do Guru (usado pra verificar origem de webhook). Arg: account_token.
- guru_affiliations_assets(id?: string, cursor?: string, account?: string, ids?: string[]) — Afiliações no Guru (leitura). Ações: list (cursor); get (id); assets (id); transactions (id).
- guru_affiliations_get(id?: string, cursor?: string, account?: string, ids?: string[]) — Afiliações no Guru (leitura). Ações: list (cursor); get (id); assets (id); transactions (id).
- guru_affiliations_list(id?: string, cursor?: string, account?: string, ids?: string[]) — Afiliações no Guru (leitura). Ações: list (cursor); get (id); assets (id); transactions (id).
- guru_affiliations_transactions(id?: string, cursor?: string, account?: string, ids?: string[]) — Afiliações no Guru (leitura). Ações: list (cursor); get (id); assets (id); transactions (id).
- guru_affiliations_write_set_commission(id: string, data?: object, account?: string, ids?: string[]) — Mutações em afiliações Guru. Ação: set_commission (id + data com a comissão).
- guru_blocklists_get(id?: string, cursor?: string, account?: string, ids?: string[]) — Listas de bloqueio (anti-fraude) no Guru. Ações: list (cursor); get (id).
- guru_blocklists_list(id?: string, cursor?: string, account?: string, ids?: string[]) — Listas de bloqueio (anti-fraude) no Guru. Ações: list (cursor); get (id).
- guru_blocklists_write_create(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em listas de bloqueio Guru. Ações: create (data); update (id + data); delete (id).
- guru_blocklists_write_delete(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em listas de bloqueio Guru. Ações: create (data); update (id + data); delete (id).
- guru_blocklists_write_update(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em listas de bloqueio Guru. Ações: create (data); update (id + data); delete (id).
- guru_checkout(data?: object, account?: string) — Consulta/configura settings de oferta no checkout do Guru (POST checkout/offers/settings). Arg: data com os parâmetros da oferta.
- guru_contacts_affiliations(id?: string, email?: string, doc?: string, name?: string, created_at_ini?: string, created_at_end?: string, cursor?: string, account?: string, ids?: string[]) — Contatos/clientes no Guru (leitura).
- guru_contacts_etickets(id?: string, email?: string, doc?: string, name?: string, created_at_ini?: string, created_at_end?: string, cursor?: string, account?: string, ids?: string[]) — Contatos/clientes no Guru (leitura).
- guru_contacts_get(id?: string, email?: string, doc?: string, name?: string, created_at_ini?: string, created_at_end?: string, cursor?: string, account?: string, ids?: string[]) — Contatos/clientes no Guru (leitura).
- guru_contacts_search(id?: string, email?: string, doc?: string, name?: string, created_at_ini?: string, created_at_end?: string, cursor?: string, account?: string, ids?: string[]) — Contatos/clientes no Guru (leitura).
- guru_contacts_subscriptions(id?: string, email?: string, doc?: string, name?: string, created_at_ini?: string, created_at_end?: string, cursor?: string, account?: string, ids?: string[]) — Contatos/clientes no Guru (leitura).
- guru_contacts_transactions(id?: string, email?: string, doc?: string, name?: string, created_at_ini?: string, created_at_end?: string, cursor?: string, account?: string, ids?: string[]) — Contatos/clientes no Guru (leitura).
- guru_contacts_write_anonymize(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em contatos Guru.
- guru_contacts_write_create(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em contatos Guru.
- guru_contacts_write_create_etickets(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em contatos Guru.
- guru_contacts_write_update(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em contatos Guru.
- guru_countries_address(country?: string, zipcode?: string, account?: string) — Dados auxiliares de localização do Guru. Ações: list (países); states (country, ex.: BR); address (zipcode/CEP BR).
- guru_countries_list(country?: string, zipcode?: string, account?: string) — Dados auxiliares de localização do Guru. Ações: list (países); states (country, ex.: BR); address (zipcode/CEP BR).
- guru_countries_states(country?: string, zipcode?: string, account?: string) — Dados auxiliares de localização do Guru. Ações: list (países); states (country, ex.: BR); address (zipcode/CEP BR).
- guru_coupons_audits(id?: string, cursor?: string, account?: string, ids?: string[]) — Cupons no Guru (leitura). Ações: list (cursor); get (id); audits (id); transactions (id).
- guru_coupons_get(id?: string, cursor?: string, account?: string, ids?: string[]) — Cupons no Guru (leitura). Ações: list (cursor); get (id); audits (id); transactions (id).
- guru_coupons_list(id?: string, cursor?: string, account?: string, ids?: string[]) — Cupons no Guru (leitura). Ações: list (cursor); get (id); audits (id); transactions (id).
- guru_coupons_transactions(id?: string, cursor?: string, account?: string, ids?: string[]) — Cupons no Guru (leitura). Ações: list (cursor); get (id); audits (id); transactions (id).
- guru_coupons_write_create(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em cupons Guru.
- guru_coupons_write_delete(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em cupons Guru.
- guru_coupons_write_duplicate(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em cupons Guru.
- guru_coupons_write_set_activation(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em cupons Guru.
- guru_coupons_write_update(id?: string, data?: object, account?: string, ids?: string[]) — Mutações em cupons Guru.
- guru_etickets_check_in(code?: string, cursor?: string, account?: string) — Ingressos (e-tickets) no Guru (leitura). Ações: list (cursor); get (code); check_in (code, status de check-in).
- guru_etickets_get(code?: string, cursor?: string, account?: string) — Ingressos (e-tickets) no Guru (leitura). Ações: list (cursor); get (code); check_in (code, status de check-in).
- guru_etickets_list(code?: string, cursor?: string, account?: string) — Ingressos (e-tickets) no Guru (leitura). Ações: list (cursor); get (code); check_in (code, status de check-in).
- guru_etickets_write_create_invitations(code: string, data?: object, account?: string) — Mutações em e-tickets Guru.
- guru_etickets_write_delete(code: string, data?: object, account?: string) — Mutações em e-tickets Guru.
- guru_etickets_write_delete_check_in(code: string, data?: object, account?: string) — Mutações em e-tickets Guru.
- guru_etickets_write_delete_invitations(code: string, data?: object, account?: string) — Mutações em e-tickets Guru.
- guru_etickets_write_do_check_in(code: string, data?: object, account?: string) — Mutações em e-tickets Guru.
- guru_leads(cursor?: string, account?: string) — Lista leads no Guru (cursor).
- guru_list_accounts(account?: string) — Lista contas Digital Manager Guru vinculadas a este install — id e apelido.
- guru_myorders(email: string, data?: object, account?: string) — Gera link SSO da área de compras (MyOrders) de um comprador pelo email (POST myorders/auth/sso/:email).
- guru_products_checkout_options(product_id?: string, offer_id?: string, section?: string, name?: string, type?: string, marketplace_id?: string, is_hidden?: integer, cursor?: string, account?: string, product_ids?: string[], offer_ids?: string[], marketplace_ids?: string[]) — Produtos e ofertas no Guru (leitura).
- guru_products_get(product_id?: string, offer_id?: string, section?: string, name?: string, type?: string, marketplace_id?: string, is_hidden?: integer, cursor?: string, account?: string, product_ids?: string[], offer_ids?: string[], marketplace_ids?: string[]) — Produtos e ofertas no Guru (leitura).
- guru_products_list(product_id?: string, offer_id?: string, section?: string, name?: string, type?: string, marketplace_id?: string, is_hidden?: integer, cursor?: string, account?: string, product_ids?: string[], offer_ids?: string[], marketplace_ids?: string[]) — Produtos e ofertas no Guru (leitura).
- guru_products_offer(product_id?: string, offer_id?: string, section?: string, name?: string, type?: string, marketplace_id?: string, is_hidden?: integer, cursor?: string, account?: string, product_ids?: string[], offer_ids?: string[], marketplace_ids?: string[]) — Produtos e ofertas no Guru (leitura).
- guru_products_offer_checkout_options(product_id?: string, offer_id?: string, section?: string, name?: string, type?: string, marketplace_id?: string, is_hidden?: integer, cursor?: string, account?: string, product_ids?: string[], offer_ids?: string[], marketplace_ids?: string[]) — Produtos e ofertas no Guru (leitura).
- guru_products_offer_subscription_options(product_id?: string, offer_id?: string, section?: string, name?: string, type?: string, marketplace_id?: string, is_hidden?: integer, cursor?: string, account?: string, product_ids?: string[], offer_ids?: string[], marketplace_ids?: string[]) — Produtos e ofertas no Guru (leitura).
- guru_products_offers(product_id?: string, offer_id?: string, section?: string, name?: string, type?: string, marketplace_id?: string, is_hidden?: integer, cursor?: string, account?: string, product_ids?: string[], offer_ids?: string[], marketplace_ids?: string[]) — Produtos e ofertas no Guru (leitura).
- guru_products_subscription_options(product_id?: string, offer_id?: string, section?: string, name?: string, type?: string, marketplace_id?: string, is_hidden?: integer, cursor?: string, account?: string, product_ids?: string[], offer_ids?: string[], marketplace_ids?: string[]) — Produtos e ofertas no Guru (leitura).
- guru_products_write_set_offer_availability(product_id: string, offer_id: string, data?: object, account?: string, product_ids?: string[], offer_ids?: string[]) — Mutações em produtos Guru. Ação: set_offer_availability (product_id + offer_id + data com a disponibilidade).
- guru_subscriptions_activities(id?: string, invoice_code?: string, subscription_status?: string, product_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, started_at_ini?: string, started_at_end?: string, last_status_at_ini?: string, last_status_at_end?: string, cursor?: string, account?: string, ids?: string[], product_ids?: string[]) — Assinaturas no Guru (leitura).
- guru_subscriptions_get(id?: string, invoice_code?: string, subscription_status?: string, product_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, started_at_ini?: string, started_at_end?: string, last_status_at_ini?: string, last_status_at_end?: string, cursor?: string, account?: string, ids?: string[], product_ids?: string[]) — Assinaturas no Guru (leitura).
- guru_subscriptions_invoice(id?: string, invoice_code?: string, subscription_status?: string, product_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, started_at_ini?: string, started_at_end?: string, last_status_at_ini?: string, last_status_at_end?: string, cursor?: string, account?: string, ids?: string[], product_ids?: string[]) — Assinaturas no Guru (leitura).
- guru_subscriptions_invoice_transactions(id?: string, invoice_code?: string, subscription_status?: string, product_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, started_at_ini?: string, started_at_end?: string, last_status_at_ini?: string, last_status_at_end?: string, cursor?: string, account?: string, ids?: string[], product_ids?: string[]) — Assinaturas no Guru (leitura).
- guru_subscriptions_invoices(id?: string, invoice_code?: string, subscription_status?: string, product_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, started_at_ini?: string, started_at_end?: string, last_status_at_ini?: string, last_status_at_end?: string, cursor?: string, account?: string, ids?: string[], product_ids?: string[]) — Assinaturas no Guru (leitura).
- guru_subscriptions_payment_types(id?: string, invoice_code?: string, subscription_status?: string, product_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, started_at_ini?: string, started_at_end?: string, last_status_at_ini?: string, last_status_at_end?: string, cursor?: string, account?: string, ids?: string[], product_ids?: string[]) — Assinaturas no Guru (leitura).
- guru_subscriptions_plans_available(id?: string, invoice_code?: string, subscription_status?: string, product_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, started_at_ini?: string, started_at_end?: string, last_status_at_ini?: string, last_status_at_end?: string, cursor?: string, account?: string, ids?: string[], product_ids?: string[]) — Assinaturas no Guru (leitura).
- guru_subscriptions_search(id?: string, invoice_code?: string, subscription_status?: string, product_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, started_at_ini?: string, started_at_end?: string, last_status_at_ini?: string, last_status_at_end?: string, cursor?: string, account?: string, ids?: string[], product_ids?: string[]) — Assinaturas no Guru (leitura).
- guru_subscriptions_transactions(id?: string, invoice_code?: string, subscription_status?: string, product_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, started_at_ini?: string, started_at_end?: string, last_status_at_ini?: string, last_status_at_end?: string, cursor?: string, account?: string, ids?: string[], product_ids?: string[]) — Assinaturas no Guru (leitura).
- guru_subscriptions_write_add_coupon(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_cancel(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_cancel_at_cycle_end(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_change_plan(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_remove_coupon(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_remove_increment_discount(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_set_current_offer(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_set_cycle_end_date(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_set_increment_discount(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_set_installment(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_set_next_offer(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_set_payment_types(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_set_trial_end_date(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_subscriptions_write_simulate_plan(id: string, data?: object, account?: string, ids?: string[]) — Mutações em assinaturas Guru.
- guru_transactions_activities(id?: string, marketplace_name?: string, marketplace_id?: string, sub?: string, ordered_at_ini?: string, ordered_at_end?: string, confirmed_at_ini?: string, confirmed_at_end?: string, transaction_status?: string, product_id?: string, subscription_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, cursor?: string, account?: string, ids?: string[], marketplace_ids?: string[], product_ids?: string[], subscription_ids?: string[]) — Vendas/transações no Guru (leitura).
- guru_transactions_by_marketplace(id?: string, marketplace_name?: string, marketplace_id?: string, sub?: string, ordered_at_ini?: string, ordered_at_end?: string, confirmed_at_ini?: string, confirmed_at_end?: string, transaction_status?: string, product_id?: string, subscription_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, cursor?: string, account?: string, ids?: string[], marketplace_ids?: string[], product_ids?: string[], subscription_ids?: string[]) — Vendas/transações no Guru (leitura).
- guru_transactions_etickets(id?: string, marketplace_name?: string, marketplace_id?: string, sub?: string, ordered_at_ini?: string, ordered_at_end?: string, confirmed_at_ini?: string, confirmed_at_end?: string, transaction_status?: string, product_id?: string, subscription_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, cursor?: string, account?: string, ids?: string[], marketplace_ids?: string[], product_ids?: string[], subscription_ids?: string[]) — Vendas/transações no Guru (leitura).
- guru_transactions_get(id?: string, marketplace_name?: string, marketplace_id?: string, sub?: string, ordered_at_ini?: string, ordered_at_end?: string, confirmed_at_ini?: string, confirmed_at_end?: string, transaction_status?: string, product_id?: string, subscription_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, cursor?: string, account?: string, ids?: string[], marketplace_ids?: string[], product_ids?: string[], subscription_ids?: string[]) — Vendas/transações no Guru (leitura).
- guru_transactions_order_bumps(id?: string, marketplace_name?: string, marketplace_id?: string, sub?: string, ordered_at_ini?: string, ordered_at_end?: string, confirmed_at_ini?: string, confirmed_at_end?: string, transaction_status?: string, product_id?: string, subscription_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, cursor?: string, account?: string, ids?: string[], marketplace_ids?: string[], product_ids?: string[], subscription_ids?: string[]) — Vendas/transações no Guru (leitura).
- guru_transactions_search(id?: string, marketplace_name?: string, marketplace_id?: string, sub?: string, ordered_at_ini?: string, ordered_at_end?: string, confirmed_at_ini?: string, confirmed_at_end?: string, transaction_status?: string, product_id?: string, subscription_id?: string, contact_email?: string, contact_doc?: string, contact_name?: string, cursor?: string, account?: string, ids?: string[], marketplace_ids?: string[], product_ids?: string[], subscription_ids?: string[]) — Vendas/transações no Guru (leitura).
- guru_transactions_write_chargeback(id: string, data?: object, account?: string, ids?: string[]) — Mutações em transações Guru (mexe em dinheiro, irreversível).
- guru_transactions_write_generate_invoice(id: string, data?: object, account?: string, ids?: string[]) — Mutações em transações Guru (mexe em dinheiro, irreversível).
- guru_transactions_write_refund(id: string, data?: object, account?: string, ids?: string[]) — Mutações em transações Guru (mexe em dinheiro, irreversível).
- guru_transactions_write_reissue(id: string, data?: object, account?: string, ids?: string[]) — Mutações em transações Guru (mexe em dinheiro, irreversível).
- guru_transactions_write_update_buyer(id: string, data?: object, account?: string, ids?: string[]) — Mutações em transações Guru (mexe em dinheiro, irreversível).
- guru_users_activities(id?: string, cursor?: string, account?: string, ids?: string[]) — Usuários/membros da conta Guru (leitura). Ações: list (cursor); get (id); activities (id).
- guru_users_get(id?: string, cursor?: string, account?: string, ids?: string[]) — Usuários/membros da conta Guru (leitura). Ações: list (cursor); get (id); activities (id).
- guru_users_list(id?: string, cursor?: string, account?: string, ids?: string[]) — Usuários/membros da conta Guru (leitura). Ações: list (cursor); get (id); activities (id).
- guru_users_write_delete(id: string, account?: string, ids?: string[]) — Mutações em usuários Guru. Ação: delete (id, remove o usuário da conta).
- guru_webhooks_activities(id?: string, cursor?: string, account?: string, ids?: string[]) — Webhooks configurados no Guru. Ações: list (cursor); get (id); activities (id, entregas).
- guru_webhooks_get(id?: string, cursor?: string, account?: string, ids?: string[]) — Webhooks configurados no Guru. Ações: list (cursor); get (id); activities (id, entregas).
- guru_webhooks_list(id?: string, cursor?: string, account?: string, ids?: string[]) — Webhooks configurados no Guru. Ações: list (cursor); get (id); activities (id, entregas).

## Example prompts
- "Which approved sales did I have on Guru in the last 7 days?"
- "List my active subscriptions"
- "Show transactions for the contact with email X"

## Links
Docs: https://mcp.ai/docs/mcps/guru
Website: https://mcp.ai/mcps/guru