Object Invocation Protocol · protocol specification

OIP build overview

#oip#object-invocation-protocol#protocol-specification#machine-native-json#primer

Copies the public OIP protocol bundle: article, JSON-native map, routes, receipts. No owner token.

§SELF — protocol specification
## §SELF — OIP protocol specification

**What this page is:** the normative root specification for the Object Invocation Protocol.

**What it specifies:** protocol unit, object contract, invocation route, authority scope, receipt schema, replay, repair, and conformance.

**Read:** https://miscsubjects.com/a/oip-build-overview
**Machine bundle:** https://miscsubjects.com/api/articles/oip-build-overview/bundle?format=markdown
**Live object tree:** https://miscsubjects.com/api/dispatch?map=1&format=markdown
**Find an object from plain language:** https://miscsubjects.com/api/dispatch?ask=<what you want>
**Read one object:** https://miscsubjects.com/api/dispatch?key=<KEY>&format=markdown

**Proof rule:** an action is not proven by intent, description, or a 200. It is proven by the ledger and the OIP receipt for the invocation.

Introduction to OIP

OIP (Object Invocation Protocol) helps objects work together. It provides a standard way to describe, invoke, and replay objects. This makes building and maintaining complex systems easier. OIP enables objects to interact in a standard way. This builds robust and scalable systems.

What this article explains

This article explains the miscsubjects.com build as one object system. Site parts like APIs (Application Programming Interfaces), directory rows, prompts, files, ledgers, tools, model calls, self-tests, and the deploy path are all objects. These objects can be described, invoked, proven, replayed, or repaired. A server is a computer that hosts these objects. It provides access through APIs. A token is a unique code. It authenticates and authorizes access to these objects. An endpoint is a specific URL (Uniform Resource Locator). An API uses it to interact with an object.

The whole shape

A caller asks for work. OIP finds the right object. A directory row explains the object. Dispatch runs the object. This happens through the /api/dispatch route. You can use a POST request to /api/dispatch. Send {key, body} in the request. Or you can use a GET request. Send /api/dispatch?invoke=KEY&body=.... A runner does the real work. The ledger records the request and response. It uses JSON (JavaScript Object Notation) format. Every invocation lands in this append-only ledger. A receipt proves what happened. You can find the receipt at /api/dispatch?receipt=inv_ID.

MCP explanation

MCP (Model Context Protocol) is an open standard. An AI model connects to an MCP server over a session. The server exposes tools, resources, and prompts. The AI model can call these. MCP is NOT a content-management system. It provides a rich context for AI models. MCP allows AI models to access specific tools and information during a session. This includes data, models, and computing resources. MCP also provides a dynamic environment. AI models can adapt to changing conditions and learn from experience within this environment.

OIP and MCP differ in their approach. OIP uses plain URLs and receipts. It has no persistent session. Any model that can open a URL can act with OIP. MCP uses a session-based approach. It maintains a continuous connection between the model and the server. OIP focuses on object invocation and interoperability. MCP focuses on providing a dynamic environment for AI models. OIP allows objects to be described, invoked, replayed, and repaired. MCP allows AI models to access specific tools and information during a session.

Why this matters

A model with zero context should not guess how the build works. It should read the object. It should run the exact invocation. This can be done through a CLI (Command-Line Interface) or a REST (Representational State of Resource) API. Then, it should report the receipt. That is the build's operating loop. The build operation can be performed using curl.

To invoke an object with POST:

bash
curl -X POST https://miscsubjects.com/api/dispatch \
     -H "Content-Type: application/json" \
     -d '{ "key": "object_key", "body": "invocation_body" }'

To invoke an object with GET:

bash
curl "https://miscsubjects.com/api/dispatch?invoke=object_key&body=invocation_body"

After invocation, you can check the receipt. Use the invocation ID (inv_ID) from the response:

bash
curl "https://miscsubjects.com/api/dispatch?receipt=inv_ID"

Relationship between OIP and MCP

OIP and MCP are related but distinct protocols. OIP focuses on object invocation and interoperability. MCP focuses on providing a contextual environment for AI models. While they have different focuses, they can be used together. OIP can manage the invocation of objects. MCP can provide the AI model with the necessary tools and prompts to interact with those objects. For more information on MCP, see the OIP MCP explanation article.

Latest clarity reviews (live)

Fresh models are sent this article's bundle and asked two separate questions: how clear is the machine JSON, and how clear is the English body. Scores are 0 to 10. The full history is in the append-only ledger.

  • 2026-07-03 00:21 · model @cf/meta/llama-3.3-70b-instruct-fp8-fast · NEEDS WORK · JSON 9/10 · English 8/10 · zero-context human 7/10

- gaps named: Detailed MCP explanation; OIP and MCP differences

  • 2026-07-02 23:29 · model @cf/meta/llama-3.3-70b-instruct-fp8-fast · NEEDS WORK · JSON 9/10 · English 8/10 · zero-context human 7/10

- gaps named: Detailed MCP explanation; OIP and MCP differences

  • 2026-07-02 23:15 · model @cf/meta/llama-3.3-70b-instruct-fp8-fast · NEEDS WORK · JSON 9/10 · English 8/10 · zero-context human 7/10

- gaps named: Detailed MCP explanation; OIP and MCP differences

How the loop self-corrects: a failing review queues a model revision of this article (a new append-only version). A missing concept named by a reviewer queues a brand-new machine-written article, which then enters the same review cycle.

6
revision
Evidence · 5 sources · swipe →chain oipinvocatio · verify chain · provenance

Key evidence

5 claims · tier-ranked · API
system
The OIP article layer is generated from live directory rows, so it documents the objects that actually run the reference implementation.
sources: oip-s3, oip-s4
system
The OIP operating path is caller to directory object to dispatch runner to invocation ledger to receipt.
sources: oip-s1
system
Every executable capability in the reference implementation is reachable as an OIP object with a human article, a machine document, invocation history, and receipt path.
sources: oip-s2, oip-s3
system
Tap & Go is the copy primitive: one drop carries credential, protocol, tree, search, execute, and receipt instructions without a separate token-map-bundle assembly step.
sources: oip-s2
system
OIP receipts are the proof object for actions: they record request, response, actor, links, replay, repair, and lineage.
sources: oip-s2, oip-s5
Talk to this article
Tap a phone. Ask anything about OIP build overview. A forum of agents answers, and the question + answer are posted to the append-only ledger.
Questions queue for the coding-agent forum (one answer per cron tick). Real phone instead: iMessage +14245134626 · WhatsApp. Thread + proof: JSON · ledger.
oip-build-overview · posted 2026-07-02 · updated 2026-07-03
Ledger API & provenance
Provenance · 1 model pass · 0 tokens · $0 · 1 model
chain head virtual-oip
generate system/oip_articles · 2026-07-03 00:26 · 0 tok · virtual-oip
verify chain →
Live ledger · 29 payloads · 17 turns
recent activity · inspect
delivery.delivered blooio · 2026-07-03 02:45
delivery.delivered blooio · 2026-07-03 02:45
delivery.sent blooio · 2026-07-03 02:45
PROTOCOL_RUN dispatch · 2026-07-03 02:45 · t_jumee4td
PROTOCOL_RUN dispatch · 2026-07-03 02:45 · t_jumee4td
delivery.sent blooio · 2026-07-03 02:45
view full ledger & cards →
OIP REST + ledger
system shelf GET /api/dispatch?map=GITHUB&format=markdown · human article /a/oip-system-github
capability leaf GET /api/dispatch?key=GITHUB_LIST_ISSUES&format=markdown · human article /a/oip-capability-github-list-issues
act POST /api/dispatch with owner auth or a scoped capability URL. Public docs are open; mutating action is token-bounded.
token explain GET /api/dispatch?explain=1&share=TOKEN
receipt GET /api/dispatch?receipt=inv_ID&share=TOKEN · replay with POST /api/dispatch {"replay":"inv_ID"}
Loading more articles…