Skip to content
@Biological-Sovereignty-Protocol

Biological Sovereignty Protocol

The protocol that gives every human being permanent sovereignty over their own biology.
Biological Sovereignty Protocol



The open protocol for sovereign biological data.

BSP is a neutral, open-source standard that enables any wearable, laboratory, health platform, or AI system to exchange biological data through a shared, structured, and consent-based language — where the individual always remains the owner.


Protocol License Spec License SDK npm TypeScript Python Built on Arweave


Specification · Documentation · TypeScript SDK · Python SDK · CLI · AI / MCP


The Problem

Every blood test, wearable reading, genomic result, and clinical record lives in a different system — owned by a different company, locked in a different format, invisible to everything else.

The patient does not own their data. The doctor cannot read the lab's output. The AI cannot access the hospital's records. The longevity protocol cannot execute without copy-pasting PDFs.

Three structural failures drive this:

Failure What it means
Fragmentation Every health company builds proprietary silos. No common language exists. No interoperability.
Sovereignty loss Biological data is owned by corporations and institutions — not by the person it belongs to.
AI readiness gap AI has the potential to transform medicine. But only with structured, standardized, accessible data. Today that data does not exist at scale.

BSP is the infrastructure layer that solves all three.


What BSP Is

BSP is a neutral open protocol — like HTTP for the web, or SMTP for email, but for biological data.

It defines a complete, interoperable standard for:

Object Description
BEO — Biological Entity Object The sovereign digital identity of a human being. Lifelong, cryptographically secured, individually owned.
IEO — Institutional Entity Object The verified identity of any lab, hospital, clinic, wearable, or health platform.
BioRecord The universal format for a single biological measurement — from fasting glucose to epigenetic clock scores.
ConsentToken Granular, cryptographic permission granted by the individual to an institution. Revocable at any time.
BSP Exchange The protocol for requesting, submitting, and reading biological records between systems.
Biomarker Taxonomy 200+ standardized codes across 4 levels covering the complete spectrum of measurable human biology.

BSP does not analyze data. BSP does not make medical decisions. BSP is the transport layer. Intelligence systems like AVA operate above it.


Architecture

  ┌─────────────────────────────────────────────────────────────┐
  │         INTELLIGENCE LAYER  (above the protocol)            │
  │     AVA · SVA · third-party algorithms · health apps        │
  │          not defined by BSP — consumes BSP data             │
  └────────────────────────────┬────────────────────────────────┘
                               │  reads / writes via BSP
┌──────────────────────────────▼──────────────────────────────────┐
│                      BSP PROTOCOL STACK                          │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│  LAYER 3 — BSP-EXCHANGE                                          │
│  How data moves between systems                                  │
│  Request · Response · ConsentToken · AccessControl               │
│                                                                  │
│  LAYER 2 — BSP-DATA                                              │
│  What data contains                                              │
│  BioRecord · Biomarker Taxonomy (L1 Core → L4 Device)           │
│                                                                  │
│  LAYER 1 — BSP-IDENTITY                                          │
│  Who holds the data                                              │
│  BEO (individual) · IEO (institution) · .bsp domains            │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘
  Stored on Arweave — permanent, decentralized, immutable
  BEORegistry · IEORegistry · DomainRegistry · AccessControl

Biomarker Taxonomy

BSP defines the most comprehensive open biomarker taxonomy ever codified — covering the full spectrum of measurable human biology.

Level Name Scope Categories
L1 — Core Advanced longevity Biological aging, epigenetics, telomere length, methylation clocks 9
L2 — Standard Routine laboratory Metabolic, hormonal, hematology, lipid panels — performed worldwide 9
L3 — Extended Specialized clinical Genomics, toxicology, microbiome, inflammatory markers 6
L4 — Device Continuous biometric Wearable sensor streams (HRV, SpO2, sleep, glucose CGM) 1

Every biomarker has a standardized code: BSP-{CATEGORY}-{NUMBER} (e.g., BSP-GL-001 = Fasting Glucose).

Browse the full taxonomy → bsp-spec/spec/taxonomy/


Quick Start

TypeScript / JavaScript

npm install bsp-sdk
import { BEOClient, AccessManager, BioRecordBuilder, ExchangeClient } from 'bsp-sdk'

// 1. Individual creates their sovereign biological identity
const { beo, keyPair } = await new BEOClient().create({ domain: 'andre.bsp' })

// 2. Grant consent to a laboratory — granular, revocable
const token = await new AccessManager({ beo, privateKey: keyPair.privateKey })
  .grantConsent({
    ieoId: 'sunrise-lab.bsp',
    scope: {
      intents: ['SUBMIT_RECORD', 'READ_RECORDS'],
      categories: ['METABOLIC', 'HORMONAL'],
      levels: ['STANDARD'],
      period: null,
      max_records: null,
    },
  })

// 3. Lab builds and submits a signed BioRecord
const record = new BioRecordBuilder()
  .beoId(beo.beo_id)
  .biomarker('BSP-GL-001')   // Fasting glucose — L2 Standard
  .value(94).unit('mg/dL')
  .timestamp(new Date().toISOString())
  .confidence(0.99)
  .sign(labPrivateKey)
  .build()

const result = await new ExchangeClient({ ieoId: 'sunrise-lab.bsp', privateKey: labPrivateKey })
  .submit(record, token)

console.log(result.arweave_txs[0])  // Permanent, immutable record on Arweave

Python

pip install bsp-sdk
from bsp_sdk import BioRecordBuilder, AccessManager, ExchangeClient

# Build a blood test result
record = (BioRecordBuilder()
    .beo_id("patient-beo-id")
    .biomarker("BSP-GL-001")
    .value(94).unit("mg/dL")
    .timestamp("2026-02-24T08:30:00Z")
    .confidence(0.99)
    .build())

# Submit with patient consent
token = AccessManager(ieo_id="my-lab.bsp").wait_for_approval(request_id)
result = ExchangeClient(ieo_id="my-lab.bsp").submit(record, token)
print(result["arweave_tx"])  # Permanent record

CLI

npx bspctl create andre.bsp           # Create biological identity
npx bspctl consent grant <beo> <ieo> --intents SUBMIT_RECORD --days 365
npx bspctl export <beo> --token <tok> --format FHIR_R4
npx bspctl destroy <beo> --confirm    # LGPD/GDPR erasure

AI Integration — Claude via MCP

Add BSP to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "bsp": {
      "command": "npx",
      "args": ["bsp-mcp"],
      "env": { "BSP_BEO_DOMAIN": "your-name.bsp" }
    }
  }
}

Then ask Claude: "What do my last blood test results say about my longevity markers?"


Repositories

Repository Description Status
bsp-spec Protocol specification — BEO, IEO, BioRecord formats, biomarker taxonomy, governance model v0.2 Draft
bsp-sdk-typescript Official TypeScript/JavaScript SDK — npm install bsp-sdk v1.0.0
bsp-sdk-python Official Python SDK — pip install bsp-sdk v1.0.0
bsp-cli Official CLI — manage BEOs, IEOs, consent, and health data from the terminal v1.0.0
bsp-mcp MCP server — connect Claude, ChatGPT, and other AI systems natively to BSP data v1.0.0
bsp-id-web Reference web application for BSP identity creation, consent management, and dashboard v0.1
bsp-docs Complete documentation — quickstarts, implementation guides, API reference, whitepaper Live

Design Principles

Principle What it means
Open The specification is free. No licensing fees. No permission needed. Implement it, build on it, fork it.
Neutral BSP carries data — it does not analyze it. No algorithmic bias. No health philosophy embedded in the protocol.
Sovereign Every record belongs to a biological individual. Data ownership is enforced at the protocol level, not by policy.
Extensible Versioned and backward-compatible. New biomarkers and data types can be added without breaking existing implementations.
Permanent Records are written to Arweave. They cannot be deleted, altered, or lost — by anyone, including Ambrósio.
AI-ready Structured, standardized, machine-readable by design. Any AI system can consume BSP data directly via the SDK or MCP.

Who BSP Is For

Developers building health apps, longevity platforms, or patient-facing tools that need interoperable biological data.

Laboratories and clinics that want to submit structured exam results with patient consent — without proprietary integrations.

Health platforms that want to become interoperable with any other BSP-compatible system in the world.

AI researchers and engineers who need structured, high-quality biological data for training, analysis, or real-time inference.

Individuals who want sovereign control over their own biological history and the ability to share it on their own terms.


Contributing

BSP evolves through Biological Improvement Proposals (BIPs) — a community-driven governance process modeled after established open standards (BIPs, EIPs, RFCs).

  1. Read the governance model
  2. Use the BIP template
  3. Open a Pull Request in bsp-spec

Protocol changes require community discussion and multi-signature approval from the Ambrósio Institute council.

For SDK contributions, see CONTRIBUTING.md in each repository.


License

SpecificationCreative Commons Attribution 4.0 (CC BY 4.0) Anyone may implement, build on, or distribute the BSP specification without fees or permission.

SDKsApache License 2.0


Published and governed by the Ambrósio Institute

biologicalsovereigntyprotocol.com  ·  Documentation  ·  Discussions


The protocol belongs to the world. The intelligence belongs to Ambrósio. The sovereignty belongs to the individual.

Popular repositories Loading

  1. bsp-spec bsp-spec Public

    BSP Specification — BEO, BioRecord, Exchange Protocol, Biomarker Taxonomy & Governance

  2. bsp-sdk-typescript bsp-sdk-typescript Public

    Official TypeScript/JavaScript SDK for the Biological Sovereignty Protocol — npm install @bsp/sdk

    TypeScript

  3. bsp-sdk-python bsp-sdk-python Public

    Official Python SDK for the Biological Sovereignty Protocol — pip install bsp-sdk

    Python

  4. bsp-mcp bsp-mcp Public

    Official BSP MCP Server — connect Claude, ChatGPT, and AI agents natively to the Biological Sovereignty Protocol

    JavaScript

  5. bsp-docs bsp-docs Public

    Official documentation for the Biological Sovereignty Protocol — quickstarts, guides, API reference, whitepaper

  6. .github .github Public

    Biological Sovereignty Protocol Organization Profile

Repositories

Showing 9 of 9 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…