About io.github.writesdavid/open-primitive
io.github.writesdavid/open-primitive is an MCP server in the Browser category: 16 US federal data domains as MCP tools. Signed responses with provenance.
Install
claude mcp add io-github-writesdavid-open-primitive -- npx -y open-primitive-mcpnpx -y open-primitive-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about io.github.writesdavid/open-primitive
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
Open Primitive Protocol (OPP)
The data layer of the agent internet.
OPP defines how data providers make their data agent-consumable, verifiable, and discoverable. Three components: provider manifest, response envelope, query interface.
The Problem
Agents get data naked. No provenance. No freshness guarantee. No confidence score. No way to verify the source. The agent internet is missing its data envelope.
The Protocol
| Component | What it does |
|---|---|
Manifest (/.well-known/opp.json) |
Declares what data a provider serves, how fresh it is, how to verify it |
| Response Envelope | Every response carries domain, source, freshness, confidence, citation, Ed25519 signature |
| Query Interface | Standardized HTTP GET endpoints with predictable parameters |
Conformance Levels
- Level 1 (Basic): Manifest + envelope with domain/source/freshness
- Level 2 (Cited): Level 1 + confidence scores + citations
- Level 3 (Verified): Level 2 + Ed25519 cryptographic proof
Reference Implementation
Live at api.openprimitive.com. 16 US federal data domains across 11 agencies. Level 3 compliant — every response is signed.
curl https://api.openprimitive.com/v1/drugs?name=aspirin
# Returns OPP envelope with proof.type: "DataIntegrityProof"
Quick Start
Use data from an OPP provider:
const res = await fetch('https://api.openprimitive.com/v1/drugs?name=aspirin');
const data = await res.json();
console.log(data.citations.statement);
// "According to FDA FAERS, aspirin has 601,477 reported adverse events"
Implement OPP for your own data:
// 1. Create /.well-known/opp.json (see spec)
// 2. Wrap responses in the OPP envelope
// 3. Optionally sign with Ed25519
Specification
Full spec: openprimitive.com/protocol.html
Detailed spec: api.openprimitive.com/spec.html
SDK
sdk/opp-client.js— Client library for consuming OPP providerssdk/opp-provider.js— Helper for implementing OPPsdk/opp-validator.js— Validate OPP conformance
MCP Server
13 tools for Claude, Cursor, and MCP-compatible agents:
npx open-primitive-mcp
Links
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.