English Français العربية

io.github.writesdavid/open-primitive

Registre officiel Autres

33 tools, 30 US federal data domains. Ed25519 signed, provenance chains, entity graph. Free.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package open-primitive-mcp
Claude Code 
claude mcp add open-primitive -- npx -y open-primitive-mcp@1.2.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "open-primitive": {
            "command": "npx",
            "args": [
                "-y",
                "open-primitive-mcp@1.2.0"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Open Primitive Protocol (OPP)
  2. The Problem
  3. The Protocol
  4. Conformance Levels
  5. Reference Implementation
  6. Quick Start
  7. Specification
  8. SDK
  9. MCP Server
  10. Links
  11. License

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

ComponentWhat it does
Manifest (/.well-known/opp.json)Declares what data a provider serves, how fresh it is, how to verify it
Response EnvelopeEvery response carries domain, source, freshness, confidence, citation, Ed25519 signature
Query InterfaceStandardized 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 providers
  • sdk/opp-provider.js — Helper for implementing OPP
  • sdk/opp-validator.js — Validate OPP conformance

MCP Server

13 tools for Claude, Cursor, and MCP-compatible agents:

npx open-primitive-mcp

License

MIT

Questions fréquentes

Qu'est-ce que io.github.writesdavid/open-primitive ?

33 tools, 30 US federal data domains. Ed25519 signed, provenance chains, entity graph. Free.

Comment installer io.github.writesdavid/open-primitive ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add open-primitive -- npx -y open-primitive-mcp@1.2.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.writesdavid/open-primitive ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.writesdavid/open-primitive est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.writesdavid/open-primitive ?

Il est publié par writesdavid. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.