The MythOS MCP Source Repo is the open-source GitHub repository behind the mythos-mcp 📝npm package. It contains the full 📝MCP server implementation that enables any MCP-compatible AI client to interact with 📝MythOS knowledge libraries.

What It Contains

• src/server.ts — the canonical MCP server definition: 10 tools, 4 resource types, and 3 prompt templates for interacting with MythOS libraries
• src/index.ts — the stdio entry point that reads environment variables and starts the server
• README.md — setup guides for Claude Desktop, Cursor, Windsurf, VS Code + GitHub Copilot, and other MCP clients

How to Contribute

The repo is public and MIT-licensed. To develop locally:

1. git clone https://github.com/citizens-of-one/mythos-mcp.git
1. cd mythos-mcp && npm install
1. npm run build
1. Test with: MYTHOS_API_KEY=mtk_... MYTHOS_USERNAME=yourname node dist/index.js

Relationship to Other Repos

• mythos-claude-code — the 📝Claude Code skill that wraps MCP tools with workflow patterns and auto-triggering. Uses HTTP transport directly, separate from this package.
• **studio-mythos-v3** — the main MythOS platform repo. Contains a copy of the server code at src/mcp/create-server.ts that serves the HTTP transport on Railway. This npm repo is the canonical copy going forward.

How it Works

Architecture: TypeScript compiled to ESM, single dependency (@modelcontextprotocol/sdk), published to npm as mythos-mcp. The server makes direct fetch() calls to the MythOS 📝API — no database, no state, no middleware. 7.5 kB published package.

Contexts

• 🏷️#mythos-guide