pumaDB

A URL MCP hospedada é a mesma para Codex, ChatGPT, Claude web, OpenClaw e qualquer cliente Streamable HTTP. Você conecta uma vez e todas as ferramentas autorizadas leem e escrevem as mesmas tabelas, que é justamente o sentido do pumaDB: memória que segue o seu trabalho em vez de ficar presa em um app. Não há banco de dados por ferramenta para provisionar.

Os clientes de agente se conectam por descoberta OAuth e registro automático de cliente, então você faz login com o e-mail e evita colar uma chave de API no cliente. O servidor MCP expõe ferramentas voltadas ao agente como remember, query, add, upsert, update_row e delete, que apontam para as mesmas linhas que você tocaria via REST.

Código de servidor, workers, funções serverless, ferramentas de CLI e scripts usam chaves de API bearer que começam com puma_live_. Os endpoints incluem GET /v1/{table}, POST /v1/{table}, POST /v1/{table}/update_row e DELETE /v1/{table}. A documentação é direta sobre onde as chaves devem ficar: mantenha-as fora de bundles React, sites estáticos, apps móveis e repositórios públicos.

Este é o armazenamento de memória JSON no centro do produto. As linhas são objetos JSON simples que recebem id, created_at e updated_at automaticamente. Os filtros são comparações de igualdade de primeiro nível sobre strings, números, booleanos ou nulos. Para guardar fatos e preferências estruturados que uma pessoa ou um agente possa ler diretamente, isso basta. Não é um mecanismo de recuperação, e não finge ser.

O pumaDB mantém versões arquivadas das linhas. Você pode listar versões com GET /v1/{table}/versions?id=<row-id> e restaurar uma anterior com POST /v1/{table}/restore. Para quem não se sente à vontade deixando um agente escrever na memória sem supervisão, poder ver e reverter mudanças é a diferença entre confiar ou não.

Um endpoint de lote aceita várias operações em uma só chamada, misturando ações add e delete com cargas de linhas e filtros. Se o seu app sincroniza vários registros de uma vez, você evita uma rajada de requisições de uma linha só.

A ferramenta remember guarda referências técnicas, código, Markdown e exemplos de configuração como registros inertes, feitos para serem revisados antes do uso. A intenção é que a memória possa carregar instruções sem executá-las em silêncio, o que importa quando um agente relê conteúdo que ele mesmo escreveu.