OSMP MCP Server

MCP server for the Octid Semantic Mesh Protocol (OSMP). Deterministic encode/decode of agentic AI instructions by table lookup. No inference at decode.

Install

pip install osmp-mcp

Connect

Claude Code

claude mcp add osmp -- osmp-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
    "mcpServers": {
        "osmp": {
            "command": "osmp-mcp"
        }
    }
}

Cursor / VS Code / Any MCP Client

{
    "servers": {
        "osmp": {
            "command": "osmp-mcp",
            "transport": "stdio"
        }
    }
}

Tools (8)

Resources (6)

Agent Quickstart

1. Read osmp://system_prompt

2. Use osmp_lookup to find opcodes by namespace or keyword

3. Compose SAL directly from the dictionary

4. Use osmp_discover to find domain codes you don't know (keyword + optional prefix)

5. Use osmp_resolve for exact code lookup once you have the code

6. Use osmp_compound_decode to check DAG topology before transmitting

7. Use osmp_decode to parse received instructions

Context Window Footprint

~124 tokens on connect (server instructions + tool schemas + resource listings). ~514 tokens total after reading the system prompt. Composition rules added to prevent common grammar errors observed during agent testing. Still under 0.3% of a 200K context window.

Links

• octid.io

• GitHub

• OSMP Spec

License

Apache 2.0 with express patent grant.