Rightis

Guide

Likeness rights API: check rights before generation over REST and MCP

Integrating the likeness rights API starts with the keyless public lookup GET /api/public/v1/rights/lookup?rights_id=. Agents get the same answer from the rights_lookup tool on the public MCP server at /api/public-mcp/mcp, and license issuance, usage logging and persona policy use the /api/v1 license API with a key from the developer console.

Why check rights before generating?

A service that generates a person’s face, voice or persona needs a way to know whether that person allowed it. Rightis publishes each registered person’s permitted scope as allowed, approval required or denied, and treats unregistered people as not cleared. Getting that answer before generation leaves a record of every allowed and blocked generation.

Integrated services never receive face or voice files, only registration status, permitted scope, policy and a permission answer. There is no personal data to hold.

How do I use the public lookup API?

Call GET /api/public/v1/rights/lookup?rights_id=BR-XXXX-XXXX-XXXX. No key, CORS open. A registered person returns name, permitted scope, training consent and profile URL as JSON. An unregistered one returns registered: false with a message to treat the identity as not cleared for AI use.

The lookup returns only what the holder chose to publish and is rate limited. Bulk lookups and contracts move to the keyed API.

How do I attach it to an agent over MCP?

Connect the public MCP server at /api/public-mcp/mcp and the rights_lookup tool returns the same information as the public lookup. Being keyless, it fits as a default pre-generation step for any agent.

Work that needs a contract, such as license issuance, usage logging and persona policy lookup, goes through the partner-keyed MCP server and REST API. A sandbox key is available immediately in the developer console.

Where are the license API and OpenAPI spec?

The full spec is at /api/v1/openapi.json. Creating an app in the developer console issues a sandbox key for license requests, usage logging and persona policy lookup. Policy and contract changes arrive as webhooks.

Persona policy applies per line. A character without a policy must be blocked outside its permitted assets; with a policy, tone, forms of address, banned topics and safety lines follow it.

What is recorded and how is it settled?

Allowed and blocked generations are both logged as usage. When a license becomes active a proof is issued, settlement is scheduled and events go to both the holder and the partner. Partners receive settlement events on their app’s organization.

Machine-readable signals are published too: llms.txt, ai.txt, the W3C TDM reservation file, the registry file and the do-not-train list under rightis.org’s .well-known path and root.

Steps

How integration works

  1. Call the public lookup

    Registration and permitted scope by rights_id, no key.

  2. Connect MCP to your agent

    Put the public server’s rights_lookup tool in the pre-generation step.

  3. Get a key from the developer console

    Creating an app issues a sandbox key immediately.

  4. Issue licenses and log usage

    Follow the OpenAPI spec and apply policy per line.

  5. Receive changes by webhook

    Policy versions and contract status changes arrive as events.

Try it now

Start integrating

REST, OpenAPI or MCP, whichever fits. A sandbox key is issued at signup.

Questions

Frequently asked questions

What works without a key?

The public lookup API and the public MCP server’s rights_lookup. They return registration status and the scope the holder published. Licenses, usage logs and policy lookup need a key.

Will I receive face or voice files?

No. Integrated services receive registration status, permitted scope, policy and a permission answer. Originals never leave.

What does an unregistered person return?

registered: false, a message to treat the identity as not cleared for AI use, and a registration URL.

What does it cost?

Lookup and sandbox are free. Settlement occurs on contract terms when a license is signed.

Likeness rights API: check rights before generation over REST and MCP | Rightis