Quickstart

The fastest path: give your agent one line and let it do the setup.

set up https://service.opennomos.com/SKILL.md

That file contains the host-specific commands, the OAuth step and the verification call below. You only sign in and authorize. The rest of this page is the same procedure written for humans.

1. Add the MCP serverCopy Anchor Link

The endpoint is https://mcp.opennomos.com/mcp (stateless Streamable HTTP, OAuth).

claude mcp get opennomos || claude mcp add --transport http opennomos https://mcp.opennomos.com/mcp

2. AuthorizeCopy Anchor Link

The browser opens a sign-in (email code) and a consent screen where you pick the workspace. The client stores the credentials. You do not create or paste an API key on this path.

OpenNomos supports dynamic client registration (DCR). Client ID Metadata Documents (CIMD) are not enabled on the hosted service, so hosts that only offer CIMD need to use DCR mode.

3. Verify with a real callCopy Anchor Link

Ask the agent to call discover_tools with {}:

{ "tools": [{ "name": "discover_tools", "summary": "…" }, "…"], "sources": { "web": true, "reddit": true }, "source_endpoints": { } }

A successful response proves the connection reaches your workspace. It uses the Core pack, calls no paid provider, creates no project and writes no memory. Saving the server URL alone is not a successful setup: if the host needs a reload before it shows new tools, reload and call again.

4. Try a first useful callCopy Anchor Link

{ "query": "alternatives to Notion", "sources": ["reddit", "web"], "limit": 5 }

Pass that to search_signals. You get source items back and nothing is saved. When you want to keep something, see Memory vs opportunity.

Using an API key insteadCopy Anchor Link

Hosts without OAuth support can use a key created in the console (on_live_…; shown once, stored hashed). Keep it in the host's credential store or environment:

curl --fail-with-body https://service.opennomos.com/v1/tools \
  -H "Authorization: Bearer $OPENNOMOS_API_KEY"

Details: REST and CLI.

If something failsCopy Anchor Link