osmp_encode
Encode structured fields into a SAL instruction frame.
LABSCO SUMMARY
The reason to care is the decode side, not the byte count.
Small payloads matter on a radio link, but the sharper property is that decoding requires no inference — a constrained node recovers the instruction by dictionary lookup, which means no model, no tokenizer and no ambiguity at the receiving end. That makes this interesting for mesh, satellite and embedded contexts and largely irrelevant if every hop in your system is a cloud API call. The validator is where the safety lives: it rejects hallucinated opcodes and missing consequence classes before anything is transmitted.
What it is
An encoding standard for agent instructions, with an MCP server in front of it. Instead of JSON over HTTP, instructions are written in a compact grammar that decodes by dictionary lookup rather than inference — so a receiving node recovers the structured instruction without running a model.
What you get
osmp_composeturns natural-language instructions into the encoded form, or returnsNL_PASSTHROUGHwhen no opcode matches- An
osmp://system_promptresource the agent reads on connect — the README puts it at roughly 390 tokens — teaching it the grammar, dictionary and composition rules osmp_macro_invokeresolves pre-validated multi-opcode templates, with 16 Meshtastic macros bundledosmp_resolve,osmp_batch_resolveandosmp_discoverlook codes up in the bundled domain corpora — ICD-10-CM, ISO 20022 message definitions, and MITRE ATT&CK- The MCP server wraps the Python SDK, with 19 tools by the README's count
- Encoding is bijective: every instruction compiles to a binary form and decompiles back to the identical text
- A floor guarantee — when the encoded form would be longer than the original, it transmits the original instead, so compression is never negative
Requirements
pip install osmp-mcp for the server, published as osmp-mcp version 1.3.4 over stdio; claude mcp add osmp -- osmp-mcp registers it. The SDK is separate and available per language — pip install osmp, npm install osmp-protocol, cargo add osmp, or the Go module. No account and no key. If you use the SDK path rather than MCP, the documented approach is to add the usage doctrine to your model's system prompt and wire encode, decode and validate into your own agent loop.
Setup effort
One command — pip install osmp-mcp
USE CASES
01
Sending an agent instruction over a radio link
Compose the instruction in the compact form so it fits a single low-bandwidth packet.
02
Catching an instruction the model made up
Validate against the grammar and dictionary before transmitting, so bad opcodes fail at composition time.
03
Resolving a clinical or financial code offline
Look up a code in the bundled corpora without a network call.
04
Sending telemetry from a mesh node
Invoke a pre-validated macro instead of composing the whole instruction chain each time.
19 tools
Listed in project code.
osmp_decode
Decode a SAL instruction string to structured fields and natural language. Handles compound instructions with operators (→ ∧ ∨ ; ∥ ↔).
osmp_compound_decode
Analyze DAG topology and loss tolerance behavior of a compound SAL instruction.
osmp_lookup
Search the ASD opcode dictionary by namespace and/or keyword. Returns matching opcodes with definitions.
osmp_resolve
Resolve a single domain code from a D:PACK/BLK corpus to its description.
osmp_batch_resolve
Resolve multiple domain codes in one call. Codes are comma-separated.
osmp_discover
Search a domain corpus by keyword and/or code prefix when you do not know the exact code.
osmp_benchmark
Run the canonical conformance test suite (55 vectors). Returns per-vector byte reduction and overall conformance status.
osmp_validate
Validate a composed SAL instruction against all eight composition rules before emission.
osmp_compose
Compose valid SAL from natural language.
osmp_macro_list
List all registered macros.
osmp_macro_invoke
Invoke a registered macro by ID with slot values.
osmp_bridge_register
Register a non-OSMP peer with the SAL bridge.
osmp_bridge_send
Send a SAL instruction through the bridge to a peer.
osmp_bridge_receive
Process an inbound message from a peer through the bridge.
osmp_bridge_status
Get bridge status and acquisition metrics.
osmp_bridge_comparison
Get side-by-side SAL vs NL byte comparison for all bridged messages to a peer.
osmp_eml_evaluate
Evaluate a pre-built EML corpus chain at given input value(s).
osmp_eml_corpus_lookup
Look up an EML corpus chain by name, or list all available chains.
BEFORE YOU INSTALL
What to know first
Tools you get
19 tools registered in the project's code.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install osmp-mcpMCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add osmp -- osmp-mcp
