Biological Sovereignty Protocol — Public documentation for the open standard that gives every human being permanent sovereignty over their biological data.
🌐 biologicalsovereigntyprotocol.com · Ambrósio Institute
| I want to... | Go to |
|---|---|
| Understand what BSP is | Whitepaper |
| See the 3-layer architecture | Protocol Overview |
| Integrate as a laboratory or clinic | Developer Quickstart |
| Use the CLI (fastest way) | npx bspctl create yourname.bsp |
| Onboard as a user | User Onboarding |
| Get BSP Certified | Certification Guide |
| Understand the full ecosystem flow | Ecosystem Flow |
| Document | Description |
|---|---|
| BEO Specification | Biological Entity Object — schema, key pairs, social recovery |
| IEO Specification | Institutional Entity Object — types, permissions, certification |
| ConsentToken & Access Control | How consent works, intents, revocation |
| Exchange Protocol | Request/response format, all intents, error codes |
| Biomarker Codes | Full taxonomy — 210+ biomarkers across 25 categories |
| Governance & BIP Process | How the protocol evolves — BIPs, Scientific Council, multi-sig |
| Glossary | Canonical definitions of all terms, types, and contracts |
| Guide | Description |
|---|---|
| Ecosystem Flow | Developer + user journey end-to-end |
| Security & Blockchain | Keys, Arweave, smart contracts, how each actor connects |
| GitHub Architecture | The two GitHub organizations, repos, and build sequence |
| Certification Guide | Voluntary certification — levels, process, requirements |
| User Onboarding | How users create their BEO and first BioRecord |
| CLI Reference | Complete reference for the 22 CLI commands |
| MCP Server | Connect AI agents to BSP with consent enforcement |
| Document | Description |
|---|---|
| REST API Reference | All 38 routes — BEO, IEO, consent, exchange, query |
Anyone can propose a new biomarker or protocol change. See Governance & BIP Process for the process and template.
Open an issue or pull request in this repository. All documentation is CC BY 4.0.
| Repository | Access | Purpose |
|---|---|---|
| bsp-spec | Public | Protocol specification |
| bsp-sdk-typescript | Public | TypeScript SDK (bsp-sdk) |
| bsp-sdk-python | Public | Python SDK (bsp-sdk) |
| bsp-cli | Public | CLI (npx bspctl) |
| bsp-mcp | Public | MCP server for AI connectivity |
| bsp-id-web | Public | BSP identity web application |
| bsp-docs-repo | Public | This repository |
The protocol belongs to the world. The intelligence belongs to Ambrósio. The sovereignty belongs to the individual.
License: CC BY 4.0 — Free to use, implement, and build upon.