---
title: "OAuth discovery | OAuth OIDC discovery metadata well-known | Agent-Ready Check"
description: "OAuth and OIDC discovery documents publish the issuer, authorization endpoint, token endpoint and keys an agent needs to authenticate. Pass criteria: /.well-known/oauth-authorization-server or /.well-known/openid-configuration exposes usable metadata."
locale: en
canonical: https://agent-ready.t0ols.com/checks/oauth-discovery/
---

# OAuth discovery

> Category: API, Auth, MCP & Skill Discovery

OAuth and OIDC discovery documents publish the issuer, authorization endpoint, token endpoint and keys an agent needs to authenticate.

## Why it matters

An agent that can self-configure an OAuth client does not need a human to paste credentials into a config file.

## Pass criteria

/.well-known/oauth-authorization-server or /.well-known/openid-configuration exposes usable metadata.

## How to implement it

Goal: Publish OAuth/OIDC discovery metadata so agents can authenticate with your APIs

/.well-known/oauth-authorization-server or /.well-known/openid-configuration exposes usable metadata.

The step-by-step implementation prompt is part of the paid tier. The free layer gives you the diagnosis, the evidence and the specification links.

Specifications: https://www.rfc-editor.org/rfc/rfc8414, https://openid.net/specs/openid-connect-discovery-1_0.html
Implementation notes: https://agent-ready.t0ols.com/.well-known/agent-skills/oauth-discovery/SKILL.md