Install oric

These examples use published, verified artifacts. Keep signing keys on your server.

Script tag

The relay is a route on your server. It signs calls as your registered app.

<script src="https://cdn.comms.id/oric/1.2.0.js" integrity="sha384-AHmBxVYCQDXqnwMxxte20TLMYMgReirt0VC4hdhBLGyHjJuH0ye28LuGcFvSCT26" crossorigin="anonymous"></script>
<comms-id-oric relay="/api/comms-id/oric"></comms-id-oric>

React

pnpm add @comms-id/oric-react@0.2.2 @comms-id/oric@0.5.0

import { createOricBrowserClient } from "@comms-id/oric/browser";
import { OricLookup } from "@comms-id/oric-react";

const client = createOricBrowserClient({ relayUrl: "/api/comms-id/oric" });
export const Example = () => <OricLookup client={client} />;

Server SDK

pnpm add @comms-id/oric@0.5.0

import { createOricClient } from "@comms-id/oric/server";
const client = createOricClient({
  clientId: process.env.COMMS_ID_CLIENT_ID!,
  privateJwk: JSON.parse(process.env.COMMS_ID_PRIVATE_JWK!),
});

See the operation reference for request, response and command-line examples.

Relay

Install the server relay into your relying-party app:

pnpm dlx comms-id add oric-relay

Agent tools

Product tools are served at https://mcp.comms.id. The documentation MCP serves documentation only; it does not execute product operations.

Operations

search

Read the search API reference.

lookup

Read the lookup API reference.

Upgrading

Upgrade guide.