@lifesi/genesis-mcp

The OneOS MCP server. It gives agents the Genesis services through the Genesis API at https://os.one.ml/api.

Claude Code

claude mcp add genesis --env GENESIS_API_KEY=sk_... -- npx -y @lifesi/[email protected]

Any MCP client (stdio)

{
  "mcpServers": {
    "genesis": {
      "command": "npx",
      "args": ["-y", "@lifesi/[email protected]"],
      "env": { "GENESIS_API_KEY": "sk_..." }
    }
  }
}

• Credentials: an organization API key from the Console (https://os.one.ml → API keys) in GENESIS_API_KEY. Without one, the server uses the login saved by genesis login.
• Fewer tools: set GENESIS_MCP_LAZY=1 (or pass --lazy) to list only genesis_search_tools and genesis_call instead of every operation. Every operation stays callable through genesis_call.
• Errors: error results include the gateway's code, required_scope, docs_url and request_id.
• Gateway: GENESIS_BASE_URL overrides the default https://os.one.ml/api.
• Runtime: Node.js 20.19 or later.

Use the same version as @lifesi/genesis and @lifesi/genesis-cli.

Docs: https://os.one.ml/docs