SpendTheBits Gift Cards

Permite que um agente de IA pesquise, consulte preços e compre cartões-presente reais com USDC na Base via x402. O dono da carteira define um limite por cartão e por mês, além de uma lista de marcas permitidas, aprova qualquer valor acima do limite pelo celular, e o código do cartão permanece fora do contexto do modelo, a menos que o dono permita. Execute com: npx -y @spendthebits/mcp-giftcards

Ver em spendthebits.com

Documentação

Um agente de IA pode comprar um cartão-presente real com USDC via x402. Ele solicita uma URL do cartão, paga uma pequena taxa de cotação para travar o preço exato e, em seguida, paga o pedido a um contrato por pedido na Base. Cerca de cinco minutos depois, o cartão está no aplicativo SpendTheBits do seu proprietário, em nome do proprietário. O proprietário define os limites, pode ser consultado primeiro e mantém o código, a menos que escolha compartilhá-lo.

Cada cartão é um recurso x402

Sem chamada de catálogo e sem consulta específica da SpendTheBits: a URL nomeia o cartão. A vitrine gratuita acima lista países, marcas e valores como JSON para agentes e como página para pessoas. Uma URL pagável nunca redireciona, com ou sem a barra final.

https://x402.spendthebits.com/@stb/cards/                       countries (free)
https://x402.spendthebits.com/@stb/cards/usa/?q=amazon          brands + amount URLs (free)
https://x402.spendthebits.com/@stb/cards/usa/amazon-com/25/     the card: 402 = quote fee

GET  /@stb/cards/usa/amazon-com/25/           → 402  quote fee; body.card.indicative_total_usd
     PAYMENT-SIGNATURE: <signed>              → 201  { order_id, total_usdc, pay_url, status_url, claim_token }
POST <pay_url>   PAYMENT-SIGNATURE: <signed>  → 200  paid to the order's forwarder contract
GET  <status_url>   X-Claim-Token: <token>    → awaiting_payment → processing → completed

Como um agente compra um cartão

1.Registre a chave do agente no aplicativo SpendTheBits e ative os cartões-presente para ela. Agentes → crie um agente (a chave é gerada no telefone, nunca a partir da sua frase de recuperação) → Cartões-presente: limite por cartão, limite mensal, lista de marcas opcional, Pergunte-me primeiro. Carregue apenas com o que ele pode gastar.
2.Faça GET na URL do cartão. O 402 não pago é a taxa de cotação, e seu corpo contém o total indicativo do cartão. Nada é criado no provedor do cartão por uma solicitação não paga, então navegar e precificar são gratuitos.
3.Pague a taxa de cotação com qualquer cliente x402 padrão. A resposta paga é a cotação exata: total, link de pagamento, link de status, prazo de pagamento e um token de reivindicação.
4.Pague o pedido antes do prazo de pagamento. Um pagamento USDC 'exato' na Base para o contrato encaminhador próprio do pedido. Aumente o limite por pagamento do seu cliente acima do total primeiro.
5.Consulte o link de status com o token de reivindicação até que o pedido seja lido como concluído. Cerca de cinco minutos. O cartão aparece nos pedidos do proprietário, marcado com o nome do agente.

Limites, aprovações e códigos

O que um agente pode comprar

Cartões-presente reais da loja SpendTheBits: Amazon, Starbucks, Tim Hortons e centenas de outros, resgatáveis nos EUA e no Canadá. Cartões de valor fixo vêm nos valores listados; cartões variáveis aceitam qualquer valor entre seus limites.

Para quem é o cartão

Sempre para o proprietário do agente, em nome do proprietário, no aplicativo do proprietário. Um agente não pode colocar um nome diferente em um cartão; um que tente é recusado.

Quem pode comprar

Uma chave registrada em Agentes no aplicativo do proprietário, com cartões-presente ativados para ela. Qualquer outra chave é recusada na verificação, antes que qualquer pagamento seja liquidado.

Limites do proprietário

Um limite por cartão, um limite mensal e uma lista de marcas opcional, definidos por agente no aplicativo. A loja também limita cada pedido de agente por cartão; a vitrine publica o valor atual como max_card_usd.

Pergunte primeiro

Com Pergunte-me primeiro ativado (o padrão), uma solicitação acima do limite ou de marca não listada se torna uma pergunta no telefone do proprietário em vez de uma recusa. O agente lê awaiting_owner e não deve pagar; o proprietário aprova com Face ID e paga, ou recusa.

Códigos dos cartões

Ocultos do agente por padrão. O link de status nunca contém um código. Se o proprietário permitir códigos para um agente, um link de revelação separado serve cada código uma vez e nunca mais.

O dinheiro

Pago a um contrato por pedido cujos termos são fixados em seu endereço: encaminhar ao provedor do cartão antes do prazo, pagar a taxa de serviço cotada ou reembolsar o pagador. Após o prazo, ele reembolsa integralmente. A SpendTheBits nunca o detém.

Preço

O preço do provedor mais uma pequena taxa de serviço, tudo na cotação antes de você pagar. O spread do provedor é uma parcela maior de um cartão pequeno, então compare o total com o valor de face.

Indicações: adicione ?ref=@handle a uma URL de cartão. A parcela do indicador da taxa de serviço vai para um contrato de divisão sem dono e imutável, que paga on-chain assim que cerca de US$ 0,50 se acumula ou 24 horas se passam, o que ocorrer primeiro. Presentear um cartão para outro @handle está implementado, mas não ativo; a loja recusa um destinatário hoje.

Uma compra real na mainnet, 20 de setembro de 2026

Um cliente @x402/fetch não modificado com uma chave de agente da tela Agentes do proprietário comprou um cartão Amazon.com de US$ 10. Cerca de 4,5 minutos do primeiro pagamento até um cartão concluído, e o agente nunca viu o código. Cada etapa abaixo é uma transação pública na Base (horários UTC).

Hora	Etapa	Transação
19:04:01	Taxa de cotação paga (alguns centavos)	0x265b368e…2254
19:04:03	Pedido pago: 11,224455 USDC para o encaminhador por pedido	0x5494ea30…05de
19:04:15	Encaminhador implantado = encaminhado: USDC queimado via Circle CCTP para o provedor do cartão	0xd5aecb29…1b89
~19:05	Cunhado na Ethereum para o endereço de depósito do provedor, cerca de 50 s após o pagamento	—
19:08:28	Cartão emitido: concluído, no aplicativo do proprietário	—

O encaminhador, 0x9f27…F4b1, não existia quando o agente o pagou. Seu endereço foi calculado a partir de seus termos; implantá-lo foi o encaminhamento. Leia o comunicado à imprensa sobre a primeira compra de cartão-presente por agente e como os pagamentos de agentes de IA funcionaram em produção.

Formas de um agente de IA comprar um cartão-presente com stablecoins

Vários serviços vendem cartões-presente para agentes. Eles diferem em de quem é o dinheiro que o agente gasta, o que o proprietário pode limitar e quem acaba detendo o código do cartão. Células sobre outros provedores citam suas próprias páginas.

	Cryptorefills	Bitrefill	Laso Finance	SpendTheBits
Como o agente paga	x402, USDC na Base ou Solana	Saldo de conta pré-financiado por padrão; x402 e Lightning também oferecidos	x402, liquidado na Base e Solana	x402, USDC na Base
De quem é o dinheiro e onde fica	Não informado pelo provedor	Uma conta dedicada de saldo baixo, financiada antecipadamente	Uma carteira que a Laso detém para o agente, ou a carteira do próprio agente	A chave do próprio agente, financiada pelo proprietário; nenhum saldo é retido para você
Limites definidos pelo proprietário	Não informado como recurso geral	Pré-financie apenas o que uma sessão pode gastar	Um limite por pagamento	Um limite por cartão e por mês, e uma lista de marcas permitidas
Uma pessoa aprova	Sem confirmação manual	Confirma antes da compra por padrão	Não informado para cartões-presente	Acima de um limite, o proprietário é consultado no telefone e aprova com Face ID
Conta ou identidade	Sem conta e sem KYC	Uma conta	Não informado para cartões-presente	Conta da carteira do proprietário; o cartão é emitido em nome do proprietário
Quem recebe o código do cartão	Não informado pelo provedor	Não informado pelo provedor	O chamador recebe um código de resgate	O aplicativo do proprietário; o agente apenas se o proprietário ativar isso
Servidor MCP	Oferecido	Oferecido	Oferecido	Publicado no npm e no Registro MCP oficial

Formas de um agente de IA comprar um cartão-presente com stablecoins, conforme cada provedor descreve. Última verificação em 9 de outubro de 2026 nas próprias páginas de cada fornecedor: Cryptorefills: agentes de IA, Bitrefill: MCP de eCommerce, Bitrefill: salvaguardas de agente, Laso Finance, Laso Finance: referência de agente, SpendTheBits: servidor MCP no npm. "Não informado" significa que as páginas do fornecedor não disseram, não que o recurso esteja ausente.

Exemplos e o servidor MCP

Exemplos executáveis

buy-gift-card.mjs precifica e compra um cartão com o cliente padrão e consulta o link de status sem nunca imprimir um código; gift-card-status.mjs lê um pedido com seu token de reivindicação. Ambos definem o limite por pagamento do cliente de propósito.

Servidor MCP

Um servidor MCP de primeira parte dá a um assistente seis ferramentas: busca, preço, cotação, compra, status do pedido e revelação de código único. Ele paga com o mesmo cliente x402 padrão, mantém o token de reivindicação fora do contexto do modelo e mantém seu próprio limite de gastos.

npx -y @spendthebits/mcp-giftcards

Publicado no npm e listado no Registro MCP oficial como io.github.jkambo1986-collab/stb-giftcards. Sem uma chave de agente, ele inicia somente leitura: busca, preço e status funcionam, e nada pode ser comprado.

Configuração do proprietário, passo a passo com capturas de tela: como deixar seu agente de IA comprar um cartão-presente. Vendendo em vez de comprando? Receba pagamentos de agentes de IA.

Cartões-presente para agentes: perguntas comuns

Um agente de IA pode comprar um cartão-presente com USDC?

Sim. Cada cartão na loja SpendTheBits é um recurso x402 em x402.spendthebits.com/@stb/cards/<country>/<brand>/<amount>/. Um cliente x402 padrão paga uma pequena taxa de cotação para travar o preço exato e, em seguida, paga o pedido em USDC na Base a um contrato por pedido. O cartão é emitido para o proprietário do agente e aparece no aplicativo SpendTheBits cerca de cinco minutos depois.

O agente vê o código do cartão-presente?

Não por padrão. O link de status nunca inclui um código. Um proprietário pode permitir códigos para um agente; então um link de revelação separado serve cada código exatamente uma vez.

O que acontece quando o agente solicita um cartão acima do limite do proprietário?

Com Pergunte-me primeiro ativado, o proprietário recebe uma notificação nomeando o agente, a marca, o valor e o total, e aprova ou recusa com um toque. O status do agente lê awaiting_owner e ele não deve pagar. Com Pergunte-me primeiro desativado, a solicitação é recusada antes que qualquer cobrança seja feita.

Por que meu cliente x402 se recusa a pagar pelo cartão?

Clientes padrão limitam cada pagamento a cerca de um dólar por padrão. Aumente o limite acima do total do cartão, por exemplo, spendControls.maxAmountPerPayment em @x402/fetch. O corpo 402 da URL do cartão contém um spend_controls_hint com o número a ser usado.

Quem detém o dinheiro enquanto o cartão está sendo emitido?

Ninguém. O pedido é pago a um contrato encaminhador por pedido sem dono. Ele só pode encaminhar o USDC ao provedor do cartão antes do prazo, pagar a taxa de serviço cotada ou reembolsar o pagador.

Existe um servidor MCP para cartões-presente?

Sim. O servidor de primeira parte está no npm como @spendthebits/mcp-giftcards e no Registro MCP oficial como io.github.jkambo1986-collab/stb-giftcards. Ele dá a um assistente seis ferramentas: busca, preço, cotação, compra, status do pedido e revelação de código único. Execute com npx -y @spendthebits/mcp-giftcards. Qualquer cliente x402 padrão também funciona, e exemplos executáveis estão no GitHub.