Admiral OAUTH MCP API

The oauth-mcp API from Admiral — 11 operation(s) for oauth-mcp.

GitHub OpenAPI

Operations 11

GET /.well-known/oauth-protected-resource Protected Resource Metadata #
GET /.well-known/oauth-protected-resource/mcp Protected Resource Metadata At Path #
GET /.well-known/oauth-authorization-server Authorization Server Metadata #
GET /.well-known/oauth-authorization-server/mcp Authorization Server Metadata At Path #
GET /.well-known/openai-apps-challenge Openai Apps Challenge #
POST /oauth/register Register Client #
GET /oauth/authorize Authorize #
POST /oauth/authorize/consent Consent #
POST /oauth/token Token #
POST /oauth/revoke Revoke #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/meetadmiral-com:meetadmiral-com-oauth-mcp-api"
All apis
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.

Get an API 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 Specification

meetadmiral-com-oauth-mcp-api-openapi.yml Raw ↑
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