mcpField
O
Open Primitive Mcp

Open Primitive Mcp

Local
github.com/writesdavidDeveloper Tools1Updated 27w ago
Repository

About Open Primitive Mcp

Open Primitive MCP exposes US federal data domains as tools for Claude, Cursor, and MCP-compatible agents. It is intended for applications that need cited, verifiable public data; responses include provenance, freshness, citations, and Ed25519 signatures.

Key features

  1. 01Query federal data domains through tools
  2. 02Return source and freshness information
  3. 03Include citations and confidence data
  4. 04Sign responses with Ed25519
  5. 05Provide OPP client and validation SDKs

Use cases

  1. 01Look up drug or public health data
  2. 02Retrieve weather, jobs, or demographic data
  3. 03Cite data sources in generated answers
  4. 04Verify response integrity proofs

MCP support

The MCP server provides 13 tools for Claude, Cursor, and MCP-compatible agents to query federal data. Responses use the OPP envelope and include signature and source information.

#government#federal-data#api#data#health#safety

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "open-primitive-api": {
      "command": "npx",
      "args": [
        "-y",
        "open-primitive-mcp"
      ]
    }
  }
}
Run commandnpx -y open-primitive-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmopen-primitive-mcp1.2.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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

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

Links

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.