Metadata-Version: 2.4
Name: osmp-mcp
Version: 1.0.1
Summary: MCP server for the Octid Semantic Mesh Protocol (OSMP). Encode, decode, and resolve agentic AI instructions via table lookup.
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/tree/main/mcp
Author-email: Clay Holberg <ack@octid.io>
License-Expression: Apache-2.0
Keywords: agentic,ai,edge,encoding,lora,mcp,mesh,osmp,protocol
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.2.0
Requires-Dist: zstandard>=0.22.0
Description-Content-Type: text/markdown

# osmp-mcp

<!-- mcp-name: io.github.Octid-io/osmp -->

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

## Install

```bash
pip install osmp-mcp
```

## Connect

### Claude Code
```bash
claude mcp add osmp -- osmp-mcp
```

### Claude Desktop

Add to `claude_desktop_config.json`:
```json
{
    "mcpServers": {
        "osmp": {
            "command": "osmp-mcp"
        }
    }
}
```

### Cursor / VS Code / Any MCP Client
```json
{
    "servers": {
        "osmp": {
            "command": "osmp-mcp",
            "transport": "stdio"
        }
    }
}
```

## Tools

| Tool | What it does |
|---|---|
| `osmp_encode` | Structured fields to SAL instruction (`H:HR@NODE1>120`) |
| `osmp_decode` | SAL string to structured fields (table lookup, no inference) |
| `osmp_resolve` | Domain code to SAL description from compressed binary (74,719 ICD-10-CM clinical codes, 47,835 ISO 20022 financial codes) |
| `osmp_benchmark` | Run the 48-vector canonical conformance suite |

## What ships in the package

The 1.7MB package includes the full Python SDK, the Adaptive Shared Dictionary (339 opcodes across 8 namespaces), and two D:PACK/BLK domain corpora (ICD-10-CM and ISO 20022) compressed for edge deployment. No additional downloads required.

## Links

- [octid.io](https://octid.io) -- project site
- [GitHub](https://github.com/octid-io/cloudless-sky) -- repo, spec, all three SDKs
- [OSMP Spec](https://github.com/octid-io/cloudless-sky/blob/main/protocol/spec/OSMP-SPEC-v1.md)

## License

Apache 2.0 with express patent grant.
