MewCP Stripe MCP

Cria um registro de cliente no Stripe que pode armazenar métodos de pagamento, assinaturas e faturas.

Entradas:

- `api_key` (string, required) — Stripe API key (starts with sk_)
- `email` (string, optional) — Customer's email address
- `name` (string, optional) — Customer's full name
- `description` (string, optional) — Internal description for the customer
- `metadata` (string, optional) — JSON string of metadata key-value pairs (e.g. '{"plan": "enterprise"}')

Saída:

{
  "success": true,
  "customer_id": "cus_xxx",
  "email": "user@example.com",
  "name": "Jane Doe",
  "description": "Enterprise customer",
  "created": 1716720000,
  "metadata": {}
}

Retorna detalhes completos do cliente, incluindo saldo, status de inadimplência e metadados.

Entradas:

- `api_key` (string, required) — Stripe API key
- `customer_id` (string, required) — Customer ID (e.g. cus_xxx)

Saída:

{
  "success": true,
  "customer_id": "cus_xxx",
  "email": "user@example.com",
  "name": "Jane Doe",
  "balance": 0,
  "delinquent": false,
  "created": 1716720000,
  "metadata": {}
}

Retorna até 100 clientes por página com paginação baseada em cursor.

Entradas:

- `api_key` (string, required) — Stripe API key
- `limit` (integer, optional) — Number of customers to return, 1–100 (default: 10)
- `starting_after` (string, optional) — Customer ID to paginate from

Saída:

{
  "success": true,
  "has_more": true,
  "count": 10,
  "customers": [{ "id": "cus_xxx", "email": "...", "name": "...", "created": 1716720000 }]
}

Usa a linguagem de consulta de pesquisa do Stripe para encontrar clientes que correspondam a critérios específicos.

Entradas:

- `api_key` (string, required) — Stripe API key
- `query` (string, required) — Search query (e.g. 'email:"user@example.com"' or 'name:"Jane"')
- `limit` (integer, optional) — Number of results, 1–100 (default: 10)

Saída:

{
  "success": true,
  "has_more": false,
  "count": 1,
  "customers": [{ "id": "cus_xxx", "email": "user@example.com", "name": "Jane Doe" }]
}

Cria uma cobrança direta em um cliente. O valor está na menor unidade da moeda (centavos para USD).

Entradas:

- `api_key` (string, required) — Stripe API key
- `amount` (integer, required) — Amount in cents (e.g. 1000 = $10.00)
- `currency` (string, optional) — Currency code: usd, eur, gbp, etc. (default: usd)
- `customer_id` (string, optional) — Customer ID to charge
- `description` (string, optional) — Description of the charge
- `metadata` (string, optional) — JSON string of metadata

Saída:

{
  "success": true,
  "charge_id": "ch_xxx",
  "amount": 1000,
  "currency": "usd",
  "status": "succeeded",
  "paid": true
}

Cria uma intenção de pagamento e retorna um client_secret para confirmação no frontend via Stripe.js.

Entradas:

- `api_key` (string, required) — Stripe API key
- `amount` (integer, required) — Amount in cents
- `currency` (string, optional) — Currency code (default: usd)
- `customer_id` (string, optional) — Customer ID
- `description` (string, optional) — Description
- `metadata` (string, optional) — JSON string of metadata
- `confirm` (boolean, optional) — Confirm immediately (default: false)

Saída:

{
  "success": true,
  "payment_intent_id": "pi_xxx",
  "client_secret": "pi_xxx_secret_xxx",
  "amount": 2000,
  "currency": "usd",
  "status": "requires_payment_method"
}

Cria um produto no seu catálogo do Stripe. Produtos exigem um preço antes de poderem ser vendidos.

Entradas:

- `api_key` (string, required) — Stripe API key
- `name` (string, required) — Product name
- `description` (string, optional) — Product description
- `metadata` (string, optional) — JSON string of metadata

Saída:

{
  "success": true,
  "product_id": "prod_xxx",
  "name": "Pro Plan",
  "description": "Access to all pro features",
  "active": true
}

Define o valor de cobrança e o intervalo para um produto. Suporta preços únicos e recorrentes (assinatura).

Entradas:

- `api_key` (string, required) — Stripe API key
- `product_id` (string, required) — Product ID to attach the price to
- `unit_amount` (integer, required) — Amount in cents
- `currency` (string, optional) — Currency code (default: usd)
- `recurring_interval` (string, optional) — 'month' or 'year' for subscription pricing

Saída:

{
  "success": true,
  "price_id": "price_xxx",
  "product": "prod_xxx",
  "unit_amount": 999,
  "currency": "usd",
  "recurring": { "interval": "month" }
}

Cria uma assinatura recorrente para um cliente usando um ID de preço. Suporta períodos de teste.

Entradas:

- `api_key` (string, required) — Stripe API key
- `customer_id` (string, required) — Customer ID
- `price_id` (string, required) — Price ID for the subscription plan
- `trial_period_days` (integer, optional) — Number of free trial days
- `metadata` (string, optional) — JSON string of metadata

Saída:

{
  "success": true,
  "subscription_id": "sub_xxx",
  "customer": "cus_xxx",
  "status": "active",
  "current_period_start": 1716720000,
  "current_period_end": 1719312000
}

Cancela uma assinatura no final do período de cobrança atual ou imediatamente.

Entradas:

- `api_key` (string, required) — Stripe API key
- `subscription_id` (string, required) — Subscription ID to cancel
- `cancel_at_period_end` (boolean, optional) — true = cancel at period end, false = cancel immediately (default: true)

Saída:

{
  "success": true,
  "subscription_id": "sub_xxx",
  "status": "active",
  "cancel_at_period_end": true
}

Retorna saldos disponíveis e pendentes em todas as moedas para a conta do Stripe.

Entradas:

- `api_key` (string, required) — Stripe API key

Saída:

{
  "success": true,
  "available": [{ "amount": 50000, "currency": "usd" }],
  "pending": [{ "amount": 12000, "currency": "usd" }],
  "livemode": true
}

1. Acesse o Painel do Stripe
2. Clique em Developers na navegação superior
3. Selecione API keys na barra lateral esquerda
4. Copie sua Secret key (começa com sk_live_ para produção ou sk_test_ para teste)

Use chaves sk_test_ durante o desenvolvimento — elas funcionam com números de cartão de teste e não cobram cartões reais.

• Causa: Chave de API não fornecida nos cabeçalhos da solicitação ou formato incorreto
• Solução:
  1. Verifique se os cabeçalhos Authorization: Bearer YOUR_API_KEY e X-Mewcp-Credential-Id: CREDENTIAL-ID estão presentes
  2. Confirme se a chave de API está ativa na sua conta MewCP

• Causa: As chamadas de API excederam seus limites de solicitação
• Solução:
  1. Verifique o uso de créditos no seu painel do Curious Layer
  2. Faça upgrade para um plano pago ou adicione créditos para limites maiores
  3. Entre em contato com o suporte para ajustes de crédito

• Causa: Nenhuma credencial do Stripe vinculada à sua conta
• Solução:
  1. Acesse Credentials no seu painel do MewCP
  2. Adicione sua chave de API do Stripe (autenticação estática)
  3. Tente novamente a solicitação com o cabeçalho X-Mewcp-Credential-Id correto

• Causa: O payload JSON é inválido ou está faltando campos obrigatórios
• Solução:
  1. Valide a sintaxe JSON antes de enviar
  2. Garanta que todos os parâmetros obrigatórios da ferramenta estejam incluídos
  3. Verifique se os tipos de parâmetros correspondem aos valores esperados

• Causa: Nome incorreto do servidor no endpoint da API
• Solução:
  1. Verifique o formato do endpoint: {server-name}/mcp/{tool-name}
  2. Use o nome correto do servidor conforme a documentação
  3. Verifique os servidores disponíveis na sua conta do Curious Layer

• Causa: A API upstream do Stripe retornou um erro
• Solução:
  1. Verifique o status do serviço do Stripe na Página de Status do Stripe
  2. Confirme se sua chave de API tem as permissões necessárias (modo live vs. teste)
  3. Revise a mensagem de erro para detalhes específicos — os erros do Stripe são descritivos

• Documentação da API do Stripe — Referência oficial da API
• Referência da API do Stripe — Referência completa de endpoints
• Docs do FastMCP — Especificação do FastMCP
• Credenciais do FastMCP — Pacote de Credenciais do FastMCP para gerenciamento de credenciais