Admiral OAUTH MCP API
The oauth-mcp API from Admiral — 11 operation(s) for oauth-mcp.
The oauth-mcp API from Admiral — 11 operation(s) for oauth-mcp.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/meetadmiral-com:meetadmiral-com-oauth-mcp-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Admiral OAUTH MCP API
version: 0.1.0
tags:
- name: oauth-mcp
paths:
/.well-known/oauth-protected-resource:
get:
tags:
- oauth-mcp
summary: Protected Resource Metadata
operationId: protected_resource_metadata__well_known_oauth_protected_resource_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/.well-known/oauth-protected-resource/mcp:
get:
tags:
- oauth-mcp
summary: Protected Resource Metadata At Path
description: 'The same document at the path-suffixed location.
RFC 9728 tells a client with a resource URL of `https://host/mcp` to look
at `https://host/.well-known/oauth-protected-resource/mcp`. Clients differ
on which they try, so both exist and say the same thing.'
operationId: protected_resource_metadata_at_path__well_known_oauth_protected_resource_mcp_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/.well-known/oauth-authorization-server:
get:
tags:
- oauth-mcp
summary: Authorization Server Metadata
operationId: authorization_server_metadata__well_known_oauth_authorization_server_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/.well-known/oauth-authorization-server/mcp:
get:
tags:
- oauth-mcp
summary: Authorization Server Metadata At Path
operationId: authorization_server_metadata_at_path__well_known_oauth_authorization_server_mcp_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/.well-known/openai-apps-challenge:
get:
tags:
- oauth-mcp
summary: Openai Apps Challenge
description: 'Prove to OpenAI''s plugin portal that we own this host.
The portal issues a token and then fetches it back from here before it
will accept an MCP server URL. It is a public one-line string with no
secret in it — the point is only that whoever controls this domain could
put it here.
404 while unset, which is the honest answer before a token exists: an
empty 200 would look like a host that verified and returned nothing.'
operationId: openai_apps_challenge__well_known_openai_apps_challenge_get
responses:
'200':
description: Successful Response
content:
text/plain:
schema:
type: string
/oauth/register:
post:
tags:
- oauth-mcp
summary: Register Client
description: 'Let an assistant introduce itself.
This grants nothing. A row here is a name and a list of addresses a code
may be returned to; every authorization still goes through a person who is
signed in to Admiral and choosing an account. The reason to check anything
at all is the redirect URIs, because those are the one field that can send
somebody else''s code somewhere it should not go.
RFC 7591 requires this to be open, and it is — but it was the only public
endpoint in the app with no rate limit, and every accepted POST inserts a
row. "Grants nothing" is about authority, not about cost: an unbounded
writer against a table is still a way to fill a database. The limit is
generous, because a real assistant registers once per deployment and a
developer testing an integration may legitimately do it a few dozen
times in an afternoon.'
operationId: register_client_oauth_register_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RegistrationBody'
required: true
responses:
'201':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/oauth/authorize:
get:
tags:
- oauth-mcp
summary: Authorize
description: 'Check the request, then send the person to Admiral to decide.
Everything that can be validated without knowing who the person is happens
here, because an error discovered now can be reported honestly. Once the
request is known good it is handed to the web app''s consent screen as
opaque query parameters; the screen shows the client''s name and the
accounts this person actually has, and posts back a decision.
A bad `redirect_uri` never redirects. That is the one error in OAuth that
must be shown rather than sent, since sending it is the attack.'
operationId: authorize_oauth_authorize_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/oauth/authorize/consent:
post:
tags:
- oauth-mcp
summary: Consent
description: 'A signed-in person says yes, for one named ad account.
Called by the consent screen with the person''s own Admiral session. The
account is checked against the orgs that person belongs to — a consent
screen is a form, and a form can be posted with any account id in it.'
operationId: consent_oauth_authorize_consent_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ConsentBody'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/oauth/token:
post:
tags:
- oauth-mcp
summary: Token
description: 'Exchange a code for a token, or a refresh token for a fresh pair.
Form-encoded, because that is what the specification says and what every
client sends.'
operationId: token_oauth_token_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/oauth/revoke:
post:
tags:
- oauth-mcp
summary: Revoke
description: 'RFC 7009. Always 200, even for a token that was never ours.
A revocation endpoint that distinguished "revoked" from "no such token"
would be an oracle for guessing tokens.'
operationId: revoke_oauth_revoke_post
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/oauth/consent-request:
get:
tags:
- oauth-mcp
summary: Consent Request
description: 'The client''s name, and the accounts this person could grant.
The consent screen must not take the assistant''s word for who it is, and
it must not show accounts the person cannot grant. Both answers come from
here rather than from the query string the assistant controls.'
operationId: consent_request_oauth_consent_request_get
parameters:
- name: client_id
in: query
required: true
schema:
type: string
title: Client Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ConsentBody:
properties:
client_id:
type: string
title: Client Id
redirect_uri:
type: string
title: Redirect Uri
code_challenge:
type: string
title: Code Challenge
account_id:
type: string
format: uuid
title: Account Id
state:
type: string
title: State
default: ''
resource:
anyOf:
- type: string
- type: 'null'
title: Resource
scope:
type: string
title: Scope
default: admiral:account
type: object
required:
- client_id
- redirect_uri
- code_challenge
- account_id
title: ConsentBody
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
RegistrationBody:
properties:
redirect_uris:
items:
type: string
type: array
maxItems: 10
minItems: 1
title: Redirect Uris
client_name:
type: string
maxLength: 120
title: Client Name
default: An assistant
client_uri:
anyOf:
- type: string
maxLength: 500
- type: 'null'
title: Client Uri
software_id:
anyOf:
- type: string
maxLength: 120
- type: 'null'
title: Software Id
grant_types:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Grant Types
token_endpoint_auth_method:
anyOf:
- type: string
- type: 'null'
title: Token Endpoint Auth Method
type: object
required:
- redirect_uris
title: RegistrationBody