Metadata-Version: 2.4
Name: osmp-mcp
Version: 1.0.22
Summary: OSMP MCP Server — Agentic AI instruction encoding. 86.8% byte reduction vs JSON. Inference-free decode. Any channel.
Author-email: Clay Holberg <clay@octid.io>
License: Apache License 2.0 — see https://github.com/octid-io/cloudless-sky/blob/main/LICENSE
Project-URL: Homepage, https://octid.io
Project-URL: Repository, https://github.com/octid-io/cloudless-sky
Project-URL: Documentation, https://github.com/octid-io/cloudless-sky/blob/main/docs/SAL-usage-doctrine-v1.md
Keywords: agentic,ai,encoding,lora,mcp,mesh,osmp,protocol,semantic
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: zstandard>=0.20.0
Dynamic: license-file

<!-- mcp-name: io.github.Octid-io/osmp -->
# OSMP MCP Server

MCP server for the [Octid Semantic Mesh Protocol (OSMP)](https://octid.io). Gives any MCP-compatible AI client native OSMP capability: encode, decode, validate, and resolve agentic instructions by table lookup. No inference at decode.

## Install

```
pip install osmp-mcp
```

Or with uvx:

```
uvx osmp-mcp
```

## What it does

- **osmp_encode** — Encode structured fields into a SAL instruction
- **osmp_decode** — Decode SAL to structured fields
- **osmp_validate** — Check composed SAL against composition rules before emission
- **osmp_lookup** — Search the opcode dictionary by namespace/keyword
- **osmp_resolve** — Resolve a domain code from D:PACK/BLK (ICD-10, ISO 20022, MITRE ATT&CK)
- **osmp_discover** — Search domain corpora by keyword
- **osmp_benchmark** — Run the canonical conformance suite
- **osmp_compound_decode** — Analyze DAG topology and loss tolerance
- **osmp_batch_resolve** — Multiple domain codes in one call

342 opcodes. 26 namespaces. Three MDR corpora (124,215 resolvable codes).

## Composition Rules

SAL has a grammar (how to write a legal instruction) and a usage doctrine (which instruction to write). Both matter.

**The taco test:** `K:ORD` is financial order entry (ISO 20022). "Order me some tacos" is NL passthrough, not `K:ORD[TACOS]`. Read the ASD definition, not the mnemonic.

**The lookup gate:** Always call `osmp_lookup` before composing. If the opcode doesn't exist in the dictionary, it doesn't exist in the protocol.

**Validation:** Call `osmp_validate` after composing and before emitting. It catches hallucinated opcodes, missing consequence classes, namespace-as-target errors, byte inflation, and other structural violations.

Full composition doctrine: [SAL-usage-doctrine-v1.md](https://github.com/octid-io/cloudless-sky/blob/main/docs/SAL-usage-doctrine-v1.md)

[octid.io](https://octid.io) | [GitHub](https://github.com/octid-io/cloudless-sky)
