Skip to documentation
Poolstatisdocs
Operate

Source available

Poolstatis publishes its source so teams can inspect the analytics contract, self-host the core, and contribute improvements without depending on a black-box vendor.

License

The repository uses PolyForm Shield License 1.0.0. You can use, modify, and run Poolstatis for permitted purposes, including self-hosting for your own team.

You cannot provide a competing product or service based on Poolstatis. That includes selling Poolstatis as a substitute product or offering a hosted/managed service that competes with Poolstatis Cloud.

What belongs in the repo

  • Ingest API, Platform API, MCP server, query layer, migrations, SDK, admin SPA, technical docs, and agent skills. The public landing and docs UI are maintained separately.
  • Local development workflows for contributors.
  • Clear extension points: new Query DSL branches, MCP tools, registry rules, SDK wrappers, and docs.

Commercial terms

If you want to redistribute Poolstatis as part of a commercial product, offer it as a managed service, or build something that could compete with Poolstatis Cloud, contact the maintainers for a separate commercial license.

What Cloud adds

Cloud beta is the managed service around the same product:

  • hosted admin auth for humans,
  • one-time pt_ and pk_ onboarding tokens,
  • managed ingest and retention,
  • backups, upgrades, and uptime,
  • billing meters when pricing is enabled.

Runtime access still uses scoped Poolstatis keys. Human admin auth and product/MCP runtime keys stay separate.

Contributing

Start with CONTRIBUTING.md. Small PRs are easier to review. For behavior changes, include the smallest meaningful verification:

pnpm typecheck
pnpm test
pnpm --dir web build

Database-backed tests require Docker Postgres on port 5444.