{
  "markdown": "# Open Primitive Protocol (OPP)\n\n**The data layer of the agent internet.**\n\nOPP defines how data providers make their data agent-consumable, verifiable, and discoverable. Three components: provider manifest, response envelope, query interface.\n\n## The Problem\n\nAgents 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.\n\n## The Protocol\n\n| Component | What it does |\n|-----------|-------------|\n| **Manifest** (`/.well-known/opp.json`) | Declares what data a provider serves, how fresh it is, how to verify it |\n| **Response Envelope** | Every response carries domain, source, freshness, confidence, citation, Ed25519 signature |\n| **Query Interface** | Standardized HTTP GET endpoints with predictable parameters |\n\n## Conformance Levels\n\n- **Level 1 (Basic):** Manifest + envelope with domain/source/freshness\n- **Level 2 (Cited):** Level 1 + confidence scores + citations\n- **Level 3 (Verified):** Level 2 + Ed25519 cryptographic proof\n\n## Reference Implementation\n\nLive at [api.openprimitive.com](https://api.openprimitive.com). 16 US federal data domains across 11 agencies. Level 3 compliant — every response is signed.\n\n```bash\ncurl https://api.openprimitive.com/v1/drugs?name=aspirin\n# Returns OPP envelope with proof.type: \"DataIntegrityProof\"\n```\n\n## Quick Start\n\n**Use data from an OPP provider:**\n```javascript\nconst res = await fetch('https://api.openprimitive.com/v1/drugs?name=aspirin');\nconst data = await res.json();\nconsole.log(data.citations.statement);\n// \"According to FDA FAERS, aspirin has 601,477 reported adverse events\"\n```\n\n**Implement OPP for your own data:**\n```javascript\n// 1. Create /.well-known/opp.json (see spec)\n// 2. Wrap responses in the OPP envelope\n// 3. Optionally sign with Ed25519\n```\n\n## Specification\n\nFull spec: [openprimitive.com/protocol.html](https://openprimitive.com/protocol.html)\n\nDetailed spec: [api.openprimitive.com/spec.html](https://api.openprimitive.com/spec.html)\n\n## SDK\n\n- `sdk/opp-client.js` — Client library for consuming OPP providers\n- `sdk/opp-provider.js` — Helper for implementing OPP\n- `sdk/opp-validator.js` — Validate OPP conformance\n\n## MCP Server\n\n13 tools for Claude, Cursor, and MCP-compatible agents:\n\n```bash\nnpx open-primitive-mcp\n```\n\n## Links\n\n- [Protocol Spec](https://openprimitive.com/protocol.html)\n- [API Reference](https://api.openprimitive.com)\n- [Manifesto](https://openprimitive.com/manifesto.html)\n- [OpenAPI Spec](https://api.openprimitive.com/openapi.json)\n- [OPP Manifest](https://api.openprimitive.com/.well-known/opp.json)\n\n## License\n\nMIT\n",
  "bytes": 2638,
  "sha": "317ad1214364fea99df9ddc81f8b83dc9b3de1d2a67fd352d1643a12d8752ee0",
  "repo_slug": "writesdavid/open-primitive-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_writesdavid_open_primitive_a9972fa9/readme"
}