Install

Connect pumaDB where your agents already run.

Install pumaDB as an agent memory API with no database work: use hosted MCP for agent clients, or use REST from trusted server-side apps. The MCP endpoint is https://api.pumadb.ai/mcp and uses OAuth discovery with dynamic client registration.

MCP URL https://api.pumadb.ai/mcp

API base URL https://api.pumadb.ai

Agent clients

Hosted MCP memory setup.

Hosted MCP is OAuth-oriented; headless agents should use REST unless their MCP client can complete the OAuth flow.

Codex

Add pumaDB as a hosted MCP server with the Codex CLI. Codex handles the OAuth browser flow.

codex mcp add pumadb --url https://api.pumadb.ai/mcp

ChatGPT

Open ChatGPT in your browser.
Go to Settings > Apps & Connectors.
Open Advanced settings and turn on Developer mode.
Click Create or Create app.
Name it pumaDB and paste https://api.pumadb.ai/mcp.
Use dynamic OAuth if asked, scan tools, then create the app.

Claude web

Open Customize > Connectors.
Click +, then Add custom connector.
Name it pumaDB and use https://api.pumadb.ai/mcp.
Leave OAuth client fields blank so Claude can use dynamic OAuth discovery.

Hermes

Use hosted MCP for Hermes agents and keep pumaDB as durable structured memory below Hermes' small prompt-injected memory files.

Open Hermes guide

OpenClaw

Save pumaDB in OpenClaw's MCP registry, complete OAuth login, then probe the server.

openclaw mcp set pumadb '{"url":"https://api.pumadb.ai/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"pumadb"}}'
openclaw mcp login pumadb
openclaw mcp doctor pumadb --probe

OpenClaw OAuth code

If OpenClaw prints an authorization URL and returns a code after approval, finish the login with this command.

openclaw mcp login pumadb --code <code>

OpenClaw sandbox

If OpenClaw runs sandboxed agents and MCP tools are hidden, allow the bundle MCP plugin tools in the sandbox policy.

{
  tools: {
    sandbox: {
      tools: {
        alsoAllow: ["bundle-mcp"]
      }
    }
  }
}

Any MCP client

Use the hosted Streamable HTTP MCP endpoint anywhere a remote MCP URL is accepted. Choose dynamic OAuth when the client asks about authentication.

https://api.pumadb.ai/mcp

Server-side apps

REST agent memory API setup.

Use REST from trusted backends, workers, serverless functions, CLIs, and scripts. An API key is a full-account bearer secret that starts with puma_live_; send it as Authorization: Bearer $PUMADB_API_KEY. Keep keys out of React bundles, static sites, mobile apps, public repos, and browser-executed code.

Create an initial key

Request a magic link, verify the email token, then copy the returned api_key into PUMADB_API_KEY.

curl -X POST https://api.pumadb.ai/auth/magic-link \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'

# Open the email link, or copy its token and verify it:
curl -X POST https://api.pumadb.ai/auth/verify \
  -H 'Content-Type: application/json' \
  -d '{"token":"<token-from-magic-link>"}'

# The verify response includes {"api_key":"puma_live_..."}.
export PUMADB_API_KEY="puma_live_..."

Create an app key

Use the initial key to create one named key per app and environment so credentials can be rotated independently.

curl -X POST https://api.pumadb.ai/v1/_keys \
  -H 'Authorization: Bearer $PUMADB_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"my-server-app-prod"}'