PocketAgent

Deployment

Deploy the full platform with Docker or Fly.io; distribute MCP via PyPI.

MCP-only distribution

For editor integrations, users install pokt-agent-mcp from PyPI. No separate deployment required — the MCP client spawns pocketagent-mcp locally.

Docker

The repository includes Dockerfiles for both services:

  • backend/Dockerfile — FastAPI + uvicorn
  • frontend/Dockerfile — Next.js production build
# Example: build backend image
docker build -t pocketagent-api ./backend

# Run with env file
docker run --env-file backend/.env -p 8000:8000 pocketagent-api

Fly.io

frontend/fly.toml configures the frontend app. Set secrets for API URL, WalletConnect project ID, and ensure the backend CORS origin matches your Fly hostname.

Production checklist

  1. Configure all required env vars — see Configuration
  2. Persist SQLite or migrate to a managed database path on durable volume
  3. Set NEXT_PUBLIC_API_URL without trailing slash
  4. Enable HTTPS termination at the edge
  5. Review Security before exposing write tools

Health checks

Probe GET /health on the backend. Chat SSE endpoints should not be used as health checks — they hold connections open.