🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP
Sign In

open-primitive-mcp

Package Overview
Dependencies
Maintainers
1
Versions
4
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

open-primitive-mcp

MCP server for 33 tools across 30 federal data domains — courts, federal register, education, infrastructure, unclaimed property, entity graph, subscriptions, compliance, plus flights, cars, food, water, drugs, hospitals, health, nutrition, jobs, demograp

latest
Source
npmnpm
Version
1.2.0
Version published
Maintainers
1
Created
Source

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

Keywords

mcp

FAQs

Package last updated on 05 Apr 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts