Skip to main content
S

Stone

@codespar/mcp-stone · v0.2.3

🇧🇷 BrasilPagamentosAuth · OAuth2live21 ferramentas4 variáveis de ambiente

Open banking, Pix e credenciamento de cartão. Integração TON, tags de parceiro e liquidação em tempo real pro comércio brasileiro.

Comece · grátisVer docs

MIT · roda localmente com as suas credenciais

Variáveis de ambiente, nomes e descrições das ferramentas vêm do pacote npm e ficam em inglês.

Limitações

  • O manifesto do pacote não declara 3 das 4 variáveis que o código lê.
  • Chamadas hospedadas com chave de teste não estão disponíveis: o runtime não registrou o comportamento deste provedor em teste (test venue unclassified).
Pacote
@codespar/mcp-stone
Versão
0.2.3
dist-tag npm
latest
Categoria
Pagamentos
Auth
OAuth2
País
🇧🇷 Brasil
Licença
MIT
Transporte
stdio · streamable-http

Início rápido

Instale, configure as credenciais, faça a primeira chamada.

Escolha seu cliente. O servidor roda localmente via stdio, com as suas credenciais.

Adicione o servidor ao seu clienteUma entrada de configuração. Sem build, sem SDK.
Defina as variáveis de ambiente4 variáveis lidas pelo código deste servidor, listadas abaixo.
Reinicie e faça a primeira chamadaO agente pode chamar qualquer uma das 21 ferramentas. Comece por get_balance.
terminal
# Claude Code claude mcp add stone -e STONE_AUTH_URL=… -e STONE_BASE_URL=… -e STONE_CLIENT_ID=… -e STONE_CLIENT_SECRET=… -- npx -y @codespar/mcp-stone@0.2.3 # then: /mcp to confirm the server is connected
Variáveis de ambiente4 variáveis
STONE_AUTH_URLLida pelo código; o manifesto do pacote não a declara.
STONE_BASE_URLLida pelo código; o manifesto do pacote não a declara.
STONE_CLIENT_IDLida pelo código; o manifesto do pacote não a declara.
STONE_CLIENT_SECRETAPI key for stoneobrigatóriasegredo

Nomes lidos do código do pacote (@codespar/mcp-stone@0.2.3). Descrições e marcações vêm do manifesto dele. Auto-hospedado, você guarda as credenciais.

Primeira chamada demoget_balance

"Get account balance"

tools/callget_balanceresultado devolvido

Ferramentas

O que o seu agente pode chamar.

21 ferramentas, como o tools/list do pacote as devolve.

get_balance

Get account balance

list_transactions

List account transactions

get_statement

Get account statement for a period

create_payment

Create a payment via Stone

get_payment

Get payment details by ID

list_payments

List payments with optional filters

create_transfer

Create a bank transfer (internal or external)

create_pix_payment

Create a Pix payment (outbound) via Stone

create_pix_charge

Create a Pix charge (QR Code / cob) to receive a payment

create_boleto

Create a boleto bancário for charging a customer

create_card_charge

Charge a credit or debit card (Stone acquiring)

tokenize_card

Tokenize a card to PCI-safe token for later charging

Nomes e descrições vêm do tools/list do pacote (@codespar/mcp-stone@0.2.3). Um tipo (leitura, escrita, exclusão) só aparece quando o pacote anota suas ferramentas ou cada ferramenta foi verificada uma a uma; nenhum dos dois existe ainda para este servidor.

Compatibilidade

MCP é um protocolo. Qualquer cliente que o fale pode montar este servidor.

O codespar_discover lista as ferramentas deste servidor, mas um projeto com chave de teste ainda não consegue chamá-las: o runtime não registrou o que este provedor faz em modo de teste e recusa em vez de adivinhar.

Protocolo

Qualquer cliente MCP

stdio · streamable-http

Perguntas

Antes de instalar.

Como instalo o servidor MCP Stone?

Rode npx -y @codespar/mcp-stone@0.2.3 e adicione o bloco de configuração acima ao seu cliente MCP: Claude Code, Cursor, Claude Desktop, VS Code ou qualquer cliente compatível. Sem build, sem SDK.

O que meu agente pode fazer com Stone?

Stone expõe 21 ferramentas de pagamentos. Seu agente as chama diretamente; a lista completa está acima.

Como Stone autentica, e como as credenciais são guardadas?

Stone usa OAuth2. Auto-hospedado, você guarda as credenciais: o servidor as lê das variáveis de ambiente.

Como Stone lida com mudanças na API do provedor?

Cada servidor tem versão própria no npm. O comando desta página fixa a 0.2.3, a versão cujas ferramentas estão listadas aqui; seu agente segue nela até você trocar a versão.

Stone é open source? Como reporto um bug?

Sim. Stone tem licença MIT e está publicado no npm como @codespar/mcp-stone, com o código no GitHub (link no painel Detalhes). Reporte problemas no repositório do pacote; problemas de segurança vão para security@codespar.dev, e respondemos em até 24 horas.

Comece em segundos.

Adicione a configuração acima, defina as variáveis, e seu agente chama as ferramentas.

Comece em segundos demo
Adicione o servidor ao seu cliente com a configuração acima.
Defina as variáveis de ambiente listadas acima.
Peça ao seu agente a primeira chamada.
Stone — MCP server · 21 tools | CodeSpar