MidOS Research Protocol

MidOS Research Protocol: curated skills & knowledge versioned.

MidOS MCP Community Library— Knowledge, Skills, and Research as MCP tools.

Requirement: MidOS knowledge base must be available locally. Set theMIDOS_ROOTenvironment variable to point to your MidOS installation directory (the one containingknowledge/andmodules/).

# Start server (stdio — default for Claude Code, Cursor, etc.) midos-mcp serve # Start with HTTP transport midos-mcp serve --http # Generate config for your AI client midos-mcp config --generate claude midos-mcp config --generate cursor # Check health midos-mcp health

Start the MCP server with your preferred transport.

midos-mcp serve # stdio (default) midos-mcp serve --http # Streamable HTTP on 127.0.0.1:8419 midos-mcp serve --sse # Legacy SSE transport midos-mcp serve --http --host 0.0.0.0 --port 9000

Generate ready-to-paste JSON config for any supported MCP client.

midos-mcp config --generate claude # Claude Desktop / Claude Code midos-mcp config --generate cursor # Cursor IDE midos-mcp config --generate cline # Cline (VS Code) midos-mcp config --generate windsurf # Windsurf IDE midos-mcp config --generate continue # Continue.dev midos-mcp config --generate zed # Zed Editor midos-mcp config --generate opencode # OpenCode midos-mcp config --generate http # Generic HTTP client # Write to file midos-mcp config --generate claude -o mcp-config.json

Check server health: knowledge base stats, vector store status, dependencies.

midos-mcp health # Human-readable output midos-mcp health --json # JSON output for scripts

Manage API keys for tiered access control.

midos-mcp keys generate --name "my-app" --tier dev midos-mcp keys list midos-mcp keys revoke midos_sk_abc

Tiers:dev(free),pro($10/mo),admin.

The server locates the MidOS knowledge base:
- MIDOS_ROOTenvironment variable (recommended)
- Auto-detect: walks up from package location looking forCLAUDE.md+knowledge/
- Fallback: current working directory

If you installed via pip, auto-detect won't find the knowledge base. Either:

# Option A: Clone the repo and point to it git clone https://github.com/MidOSresearch/midos.git export MIDOS_ROOT=./midos # Option B: Point to an existing MidOS directory export MIDOS_ROOT=/path/to/your/midos

Verify withmidos-mcp health— it shows the detected root and knowledge counts.

# Vector store support (LanceDB + embeddings) pip install midos-mcp[vector] # Development tools pip install midos-mcp[dev]

MidOS exposes 68 MCP tools across 2 tiers:

- Knowledge— Search 46K+ curated chunks across all domains (full content, no truncation)
- Skills— 119 reusable patterns across 16+ technology stacks
- EUREKA— 383 validated improvements with measured ROI
- Truth— 50 verified patches and corrections
- SOTA— 140 state-of-the-art convergence ceilings
- Vector Search— Semantic search via LanceDB + Gemini embeddings (3072-d)

Invalid or expired API keys silently fall back to Dev tier.

- Python 3.10+
- FastMCP 2.x
- MidOS knowledge base (local)

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Local stdio MCP server that lets AI coding agents read and maintain structured architecture, rules, and decisions directly from your repository.

Access documentation from the Awesome-llms-txt repository directly in your conversations.

An intelligent system for managing programming rules, supporting search, versioning, code validation, and prompt enhancement.

Analyze Git repositories and provide content optimized for large language models.

Transforms any GitHub project into a documentation hub, enabling AI tools to access up-to-date documentation and code.

An intelligent tutoring server that uses GitHub documentation repositories to provide structured educational prompts and tools.

Search Recon documentation, book, and newsletter for fuzzing, invariant testing, and Chimera framework knowledge

Cited compliance, legal & security intelligence for AI agents — 300+ law, regulation and standards corpora (GDPR, NIS2, AI Act, DORA) with article-level citations, plus live CVE/KEV/EPSS vulnerability context. OAuth remote server, free tier

Fetch, convert, and search AWS documentation pages, with recommendations for related content.