Osmp (octid Semantic Mesh Protocol)
@Octid-io
Agentic AI instruction encoding. 86.8% smaller than JSON. Inference-free decode by table lookup. 342 opcodes, 26 namespaces, three conformant SDKs. Confirmed over LoRa mesh radio. Apache 2.0 with express patent grant.
Overview
What is Osmp?
Osmp is an MCP server providing tools for the Octid Semantic Mesh Protocol (OSMP), an open encoding standard for agentic AI instruction exchange that works across any channel — from LoRa radio packets to cloud pipelines — using the same grammar, dictionary, and decode logic. It is designed for developers building multi-agent systems that need efficient, inference-free instruction encoding with no cloud dependency.
How to use Osmp?
Install the server with pip install osmp-mcp and run osmp-mcp. Connect from any MCP-compatible client such as Claude Code (claude mcp add osmp -- osmp-mcp), Claude Desktop, or Cursor. The server exposes 9 tools: encode, decode, compound_decode, lookup, validate, discover, resolve, batch_resolve, and benchmark.
Key features of Osmp
- 86.8% byte reduction vs JSON across 29 real-world vectors
- Inference-free decode via table lookup (ASD dictionary)
- Three domain corpora shipped: ICD‑10‑CM, ISO 20022, MITRE ATT&CK
- No cloud required; all SDKs resolve domain codes offline
- Works over any transport (LoRa, HTTP, mesh, etc.)
- BAEL floor guarantee: never makes instructions longer than natural language
Use cases of Osmp
- Agent communication over bandwidth‑constrained channels like LoRa radio
- Multi‑agent mesh networks operating without cloud or internet
- Encoding instructions for edge devices with limited memory and compute
- Replacing JSON serialization in any multi‑agent framework (MCP, A2A, etc.)
FAQ from Osmp
How does Osmp differ from other agent protocols like MCP, A2A, or ACP?
OSMP is an encoding‑layer protocol, not a framework. It operates beneath any framework protocol and works over any channel. It offers 86.8% compression vs JSON and inference‑free decode, features no other protocol provides.
What dependencies does Osmp require?
The Python SDK has no dependencies beyond the Python standard library. The MCP server also requires only Python. TypeScript and Go SDKs have minimal dependencies (TypeScript uses fzstd; Go uses klauspost/compress/zstd).
What domain codes are included with Osmp?
Three domain corpora are shipped: ICD‑10‑CM (74,719 clinical codes), ISO 20022 (47,835 financial definitions), and MITRE ATT&CK Enterprise v18.1 (1,661 entries). All are resolvable by all three SDKs without network access.
Can Osmp work completely offline?
Yes. No cloud access is required. The ASD dictionary and all shipped domain corpora are compiled into each SDK, enabling full offline operation. The protocol explicitly prohibits inference at the decode layer.
What is the compression performance of Osmp?
Measured benchmarks show 86.8% byte reduction vs JSON, 70.5% vs protobuf, and 76% fewer GPT‑4 tokens (cl100k_base). The BAEL floor ensures encoding never exceeds natural language length.
