Om MCP Quickstart

Pick your agent harness, connect the hosted Om MCP with OAuth, and run your first workflow.

5-step setup

1

Pick your agent harness

Use Claude, Codex, Cursor, VS Code, Copilot, Gemini, Grok, or another remote MCP client that supports OAuth.

2

Use the hosted MCP URL

Point your MCP client at the hosted Om MCP endpoint.

https://agents.omtx.ai/mcp
3

Add client config

Add the hosted server to your client, then complete the OAuth login flow. Om asks for email only.

4

Restart your MCP client

MCP clients need a restart before newly added servers appear in the tool list.

5

Run a smoke test

Ask for `om_status` and `credits_get`, then score a protein with `lula2_score` before Discovery, Hub, or molecule orders.

Pick your agent harness to use Om

Claude

Custom connector in Claude.ai, or claude mcp add for Claude Code.

  • Verified
Open section

Codex

ChatGPT Developer mode plugin, or codex mcp add plus email-only login.

  • Verified
Open section

Cursor

.cursor/mcp.json, then Connect in Tools & MCP.

  • Standard MCP config
Open section

VS Code

.vscode/mcp.json with type http.

  • Standard MCP config
Open section

GitHub Copilot

copilot mcp add, then copilot -i /mcp.

  • Standard MCP config
Open section

Gemini CLI

gemini mcp add, then /mcp auth omtx.

  • Standard MCP config
Open section

Grok

grok mcp add, then complete OAuth on first use.

  • Standard MCP config
Open section

Other MCP clients

Same hosted URL for any remote HTTP MCP client that can complete OAuth.

  • Standard MCP config
Open section

Remote connection details

FieldValueWhy it matters
Server URLhttps://agents.omtx.ai/mcpThis is the hosted MCP endpoint clients connect to.
Claude auth/mcpClaude Code completes remote MCP OAuth from the in-app MCP menu after the server is added.
Codex authcodex mcp login --scopes email omtxCodex can complete remote MCP OAuth after you add the server.
Other clientsclient OAuth promptCursor, VS Code, Copilot, Gemini, and Grok complete the same Om login from their own MCP connect or auth command.

Hosted. Sign in in the client.

Om MCP is hosted. Add the URL in your agent, complete the browser login, and restart the client. You do not install Om locally or paste an API key into this setup.

Smoke-test prompts

  • Run om_status. If it is healthy, show my Wallet Credits.
  • Score this protein with LULA-2 against Small Om Accessible Space and return the top 25 hits.
  • Quote Discovery for 10 molecules in Small space with AS-MS. Do not order until I confirm.
  • Launch Boltz-2 on this protein-ligand pair and wait for artifacts.
ClaudeCodexCursorOther clientsAuth & SafetyTroubleshooting