# auth.md

The Machine Relations Index API (https://machinerelations.ai/api/mri/v2), the Index MCP server (https://machinerelations.ai/mcp) and the docs MCP server (https://machinerelations.ai/docs/mcp) are public and read-only. No account, API key, OAuth client, or access token is required. Send HTTPS GET requests, and MCP JSON-RPC, with no Authorization header.

## Discover

The OpenAPI document is https://machinerelations.ai/api/mri/v2/openapi.json. The API catalog is https://machinerelations.ai/.well-known/api-catalog. Human instructions, including the error codes the API returns, are https://machinerelations.ai/developers.

## Pick a method

There is one method: unauthenticated reads. This site does not operate an authorization server and does not accept client credentials.

## Register

There is no client registration and no account to create for these endpoints.

## Claim

There is no identity to claim. The data is published for anyone to read.

## Exchange

There is no token endpoint and no access token to exchange. Do not look for a client id or a client secret.

## Use the access token

Do not send an access token. A request with no Authorization header is the correct call. Browser code can call the API directly: responses send Access-Control-Allow-Origin: *.

## Errors

Errors keep their HTTP status and return JSON with a machine-readable code and a human-readable message: `{ "error": { "code", "message" } }`. Typical codes are unknown_parameter (400), not_found (404), and release_unavailable (409). The OpenAPI document types those responses. There is no 401, because nothing is rejected for lack of a credential.

## Revocation

There are no credentials to revoke. Stop calling the endpoint.
