Gatewards

@gatewards/mcp-server

Um servidor MCP que permite que qualquer agente (Claude Desktop, Cursor, VS Code ou seu próprio cliente MCP) descubra e chame APIs pagas através do Gatewards — com limites de gastos por agente, deduplicação entre agentes e liquidação x402 sem custódia.

O agente mantém sua própria chave de API e carteira. O Gatewards aplica o limite de gastos no caminho da requisição: uma chamada acima do orçamento é recusada antes de ser executada, não registrada depois.

Instalação

npx @gatewards/mcp-server --api-key=gw_agent_xxx --gateway=https://api.gatewards.com

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "gatewards": {
      "command": "npx",
      "args": [
        "@gatewards/mcp-server",
        "--api-key=gw_agent_xxx",
        "--gateway=https://api.gatewards.com"
      ]
    }
  }
}

Obtenha uma chave de agente no seu painel do Gatewards.

Dois modos

Modo	Como	O que você obtém
Proxy (padrão)	--api-key=gw_agent_xxx	Roteia chamadas através do gateway. Aplicação de orçamento por agente, cache de respostas e deduplicação entre agentes. Sem carteira, sem pagamento on-chain.
x402 (autocustódia)	--private-key=0x... --rpc-url=... --usdc-address=...	O agente assina pagamentos USDC ele mesmo. Quando uma API retorna 402, o pagamento é liquidado on-chain e a requisição é repetida com um recibo. As chaves nunca saem da sua máquina.

Escolha o modo proxy para governança e cache. Adicione x402 apenas quando você realmente precisar pagar por chamada on-chain.

Ferramentas

Ferramenta	O que faz
gatewards_discover_services	Lista serviços de API pagos no marketplace (nome, endpoint, preço).
gatewards_call_api	Faz uma chamada GET/POST. Retorna status, dados e custo se um pagamento foi feito.
gatewards_check_budget	Gasto diário atual, orçamento restante e assinaturas ativas.
gatewards_get_plans	Lista planos de crédito pré-pagos para um serviço.
gatewards_subscribe	Compra um pacote de créditos para um serviço (somente modo proxy).

Configuração

Flags ou variáveis de ambiente (flags têm prioridade):

Flag	Env	Padrão	Notas
--gateway	GATEWARDS_GATEWAY_URL	http://localhost:3001	URL base do gateway.
--api-key	GATEWARDS_API_KEY	—	Chave do agente. Habilita o modo proxy.
--private-key	GATEWARDS_PRIVATE_KEY	—	Chave com prefixo 0x para o modo x402. Nunca enviada a lugar algum.
--rpc-url	GATEWARDS_RPC_URL	—	Obrigatório para o modo x402.
--usdc-address	GATEWARDS_USDC_ADDRESS	—	Obrigatório para o modo x402.
--network	GATEWARDS_NETWORK	base-sepolia	ex.: base, base-sepolia.
--merchant	GATEWARDS_MERCHANT_URL	—	Restringe URLs absolutas a esta origem.

É necessário --api-key ou --private-key.

Licença

Apache-2.0