Skip to main content

Developers · SDK & CLI

Cinco linhas da instalação ao recibo assinado.

O SDK dá ao seu backend os mesmos mandatos, regras de revisão e registros de pagamento do MCP hospedado. TypeScript e Python. A CLI cuida de chaves, mandatos e registros a partir do terminal.

As chaves de teste são gratuitas. MIT no npm e no PyPI.

demo
import { CodeSpar } from "@codespar/sdk";const session = await new CodeSpar().create("user_0000", { preset: "brazilian" });const run = await session.send("pagar a fatura da Nimbus Cloud");const status = await session.paymentStatus(run.tool_calls[0].id);// held_for_review → aprovado → pago · rec_951c
prp_77f1 held_for_reviewrec_951c assinadométodos existem no SDK
recibo demorec_951c
propostaprp_77f1 · tool_call tc_01
statusheld_for_reviewpago
trilhoboleto · liquidado 14:03:22
ed25519:9f2c…7ab1verificado

Execução em sandbox · dados de demonstração

Instalar

Escolha uma linguagem. Guarde a chave de teste em uma variável de ambiente.

TypeScript

@codespar/sdk

Cliente tipado para Node. Sessions, send, execute, charge, paymentStatus, decode e verify de mandato.

npmSDK real · 0.16.16
$ npm install @codespar/sdk + @codespar/sdk 0.16.16 · MIT

Python

codespar

O cliente Python: create, send, execute, charge, payment_status. Veja a documentação Python para o que está coberto.

pipSDK real · 0.12.0
$ pip install codespar codespar 0.12.0 · MIT

CLI

@codespar/cli

Chaves, mandatos e registros a partir do terminal. Scripts e CI.

clidemo
$ npm i -g @codespar/cli$ CODESPAR_API_KEY=csk_test_… codespar whoami User (unknown) · Organization Your company · Project default · Key env test · Scopes *

Execução em sandbox · dados de demonstração

A superfície

O que o SDK faz hoje.

Conferido contra o @codespar/sdk 0.16.16.

@codespar/sdk · 0.16.16 demoverificado
cs.create(userId, { preset })Abre uma sessão para um agentedisponível
session.send(text)Pedido em linguagem natural sob o mandatodisponível
session.execute(tool, params)Chame uma tool diretamentedisponível
session.charge({ amount, currency, method, buyer })Cria uma cobrança que uma pessoa ou um agente pode pagardisponível
session.paymentStatus(tool_call_id)Status de um pagamento · tool_call_id, não payment_iddisponível
decodeMandateToken · verifyMandateTokenLeia e verifique um mandato assinadodisponível
Webhooks de mudança de estadoPush em vez de pollingdisponível
Adaptadores de framework · OpenAI, Vercel AI SDKMesmo padrão do @codespar/claudedisponível

Mandato primeiro

O SDK nunca pede um cartão. Pede um mandato.

O seu backend guarda uma chave. O agente não guarda nada. Cada chamada roda sob uma autorização de gasto assinada: teto, escopo, validade. Pedidos que se encaixam nas suas regras de aprovação esperam revisão; pedidos fora dos limites rígidos são bloqueados.

verifyMandateToken(token) demo
agenteagt_22sh
limite por transaçãoR$ 3.000
orçamento rígidoR$ 20.000 / mês
expires31 dez 2026
ed25519 · assinaturas do emissor e do agenteok

Execução em sandbox · dados de demonstração

Dê aos seus agentes um jeito de pagar e receber.

Construir é grátis: hosted MCP, SDK e sandbox.

As chaves de teste são gratuitas.

terminal · modo de testedemo
$ npm install @codespar/sdk$ export CODESPAR_API_KEY=csk_test_…$ node pay.ts prp_77f1 · held_for_review → aprovado → pago · rec_951c

Execução em sandbox · dados de demonstração

CodeSpar · SDK e CLI