Nerdit OAuth API

MCP authorization consent for the signed-in person.

GitHub OpenAPI

Operations 3

GET /api/oauth/authorize/context Describe the pending MCP authorization the browser was handed #
POST /api/oauth/authorize/decision Approve or deny one pending MCP authorization #
GET /api/oauth/connector The MCP URL and registered client identifier for an assistant #

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/nerdit-ai:nerdit-ai-oauth-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

nerdit-ai-oauth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Nerdit Cloud (web) OAuth API
  version: 0.1.0
  description: MCP authorization consent for the signed-in person.
tags:
- name: OAuth
  description: MCP authorization consent for the signed-in person.
paths:
  /api/oauth/authorize/context:
    get:
      tags:
      - OAuth
      summary: Describe the pending MCP authorization the browser was handed
      description: Return what a grant would cover; reading never consumes or issues.
      operationId: authorize_context_api_oauth_authorize_context_get
      parameters:
      - name: rid
        in: query
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 512
          title: Rid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthorizeContextView'
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Not Found
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Conflict
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Too Many Requests
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/oauth/authorize/decision:
    post:
      tags:
      - OAuth
      summary: Approve or deny one pending MCP authorization
      description: Consume the transaction and issue a code, or report the refusal.
      operationId: authorize_decision_api_oauth_authorize_decision_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuthorizeDecisionRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthorizeDecisionView'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/oauth/connector:
    get:
      tags:
      - OAuth
      summary: The MCP URL and registered client identifier for an assistant
      description: 'Describe this account''s connector as this deployment would accept it.


        Every value is answered by asking the same question the flow itself

        would ask. The entitlement is the one that is easy to forget and the

        most confusing to get wrong: ``/oauth/authorize`` refuses an account

        without Remote Link at the consent screen, so a page that printed a URL

        and a client identifier to such an account would be sending someone to

        paste two strings and hit ``entitlement_required`` with nothing on

        screen explaining why. Unentitled reads report the refusal and no

        values.


        Deliberately *not* rate limited, unlike its two neighbours: the

        ``/claude`` page polls it every few seconds for the connection dot, and

        a budget tight enough to matter here would refuse the page rather than

        an attacker. It is a session-gated read of rows the caller already owns

        — a `GET /api/nodes` with two constants attached — so there is nothing

        on it worth flooding for. Nothing bounding it is also why what it costs

        is a property of the route rather than a detail: the entitlement and

        the node list are two independent questions and are asked at the same

        time, and the third answer — the deployment''s registered client — is

        the same row for every account here, so it is read from the cached

        snapshot rather than queried once per poll per open page.'
      operationId: connector_api_oauth_connector_get
      parameters:
      - name: client_id
        in: query
        required: false
        schema:
          anyOf:
          - enum:
            - claude
            - chatgpt
            - hermes
            type: string
          - type: 'null'
          title: Client Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorView'
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Unauthorized
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AccountAuthorizeContextView:
      properties:
        client_id:
          type: string
          title: Client Id
        client_name:
          type: string
          title: Client Name
        self_registered:
          type: boolean
          title: Self Registered
        role:
          type: string
          const: submitter
          title: Role
        scopes:
          items:
            type: string
          type: array
          title: Scopes
        redirect_uri:
          type: string
          title: Redirect Uri
        resource_kind:
          type: string
          const: account
          title: Resource Kind
        nodes:
          items:
            $ref: '#/components/schemas/AccountConsentNodeView'
          type: array
          title: Nodes
        scope_kind:
          type: string
          enum:
          - nodes
          - projects
          title: Scope Kind
        projects:
          items:
            $ref: '#/components/schemas/AccountConsentProjectView'
          type: array
          title: Projects
        already_consented:
          type: boolean
          title: Already Consented
      additionalProperties: false
      type: object
      required:
      - client_id
      - client_name
      - self_registered
      - role
      - scopes
      - redirect_uri
      - resource_kind
      - nodes
      - scope_kind
      - projects
      - already_consented
      title: AccountAuthorizeContextView
      description: A consent question for the stable account MCP gateway.
    ErrorDetail:
      properties:
        code:
          $ref: '#/components/schemas/ErrorCode'
        message:
          type: string
          title: Message
        status:
          type: integer
          title: Status
        request_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Request Id
        details:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Details
      additionalProperties: false
      type: object
      required:
      - code
      - message
      - status
      title: ErrorDetail
      description: The stable body nested under the envelope's ``error`` key.
    AccountConsentProjectView:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        node_id:
          type: string
          format: uuid
          title: Node Id
        node_name:
          type: string
          title: Node Name
        selected:
          type: boolean
          title: Selected
      additionalProperties: false
      type: object
      required:
      - id
      - name
      - node_id
      - node_name
      - selected
      title: AccountConsentProjectView
    AuthorizeContextView:
      oneOf:
      - $ref: '#/components/schemas/NodeAuthorizeContextView'
      - $ref: '#/components/schemas/AccountAuthorizeContextView'
      title: AuthorizeContextView
      description: Discriminated consent context returned under one stable endpoint.
      discriminator:
        propertyName: resource_kind
        mapping:
          account: '#/components/schemas/AccountAuthorizeContextView'
          node: '#/components/schemas/NodeAuthorizeContextView'
    ErrorCode:
      type: string
      enum:
      - bad_request
      - unauthorized
      - forbidden
      - not_found
      - method_not_allowed
      - conflict
      - validation_failed
      - rate_limited
      - internal_error
      - service_unavailable
      - not_implemented
      - plan_limit_exceeded
      - link_code_invalid
      - link_code_expired
      - link_code_consumed
      - link_code_attempts_exceeded
      - link_code_limit_exceeded
      - link_code_denied
      - link_key_invalid
      - preauth_key_limit_exceeded
      - node_not_found
      - node_already_linked
      - node_offline
      - machine_waking
      - node_revoked
      - entitlement_required
      - organisation_has_members
      - trial_quota_used
      - trial_boxes_busy
      - trial_archived
      - replace.bad_url
      - replace.extractor_unavailable
      - replace.already_claimed
      - csrf_failed
      - auth_transaction_invalid
      - auth_transaction_expired
      - auth_identity_invalid
      - auth_identity_deleting
      - session_invalid
      - session_expired
      - navigation_ticket_invalid
      - navigation_ticket_expired
      - navigation_ticket_consumed
      - proxy_session_invalid
      - proxy_session_expired
      - origin_forbidden
      - hosted_private
      - hosted_disabled
      - visitor_session_required
      - custom_domains.pro_required
      - custom_domains.limit_reached
      - custom_domains.apex_unsupported
      - custom_domains.taken
      - custom_domains.not_found
      - access_revoked
      - webhook_signature_invalid
      - already_subscribed
      - billing_account_missing
      - oauth_invalid_request
      - oauth_invalid_client
      - oauth_invalid_grant
      - oauth_unsupported_grant_type
      - oauth_invalid_scope
      - oauth_access_denied
      - oauth_server_error
      - oauth_temporarily_unavailable
      - oauth_invalid_token
      - oauth_insufficient_scope
      - protocol_version_unsupported
      - node_authentication_failed
      - relay_frame_invalid
      - relay_destination_invalid
      - relay_stream_unknown
      - relay_stream_limit_exceeded
      - relay_body_too_large
      - relay_response_too_large
      - relay_bandwidth_exceeded
      - relay_backpressure
      - relay_draining
      - relay_stream_timeout
      title: ErrorCode
      description: Codes clients may branch on independently of human-readable messages.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ConsentNodeView:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        slug:
          type: string
          title: Slug
        display_name:
          type: string
          title: Display Name
      additionalProperties: false
      type: object
      required:
      - id
      - slug
      - display_name
      title: ConsentNodeView
      description: The node a grant would apply to, named the way the console names it.
    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
    AuthorizeDecisionRequest:
      properties:
        rid:
          type: string
          maxLength: 512
          minLength: 1
          title: Rid
        decision:
          type: string
          enum:
          - approve
          - deny
          title: Decision
        node_ids:
          anyOf:
          - items:
              type: string
              format: uuid
            type: array
            maxItems: 1000
          - type: 'null'
          title: Node Ids
        scope_kind:
          anyOf:
          - type: string
            enum:
            - nodes
            - projects
          - type: 'null'
          title: Scope Kind
        project_ids:
          anyOf:
          - items:
              type: string
              maxLength: 20
              minLength: 20
              pattern: ^prj_[a-z2-7]{16}$
            type: array
            maxItems: 1000
          - type: 'null'
          title: Project Ids
      additionalProperties: false
      type: object
      required:
      - rid
      - decision
      title: AuthorizeDecisionRequest
      description: The person's answer to one pending authorize transaction.
    ConnectorNodeView:
      properties:
        node_id:
          type: string
          format: uuid
          title: Node Id
        slug:
          type: string
          title: Slug
        display_name:
          type: string
          title: Display Name
        online:
          type: boolean
          title: Online
        mcp_url:
          type: string
          title: Mcp Url
      additionalProperties: false
      type: object
      required:
      - node_id
      - slug
      - display_name
      - online
      - mcp_url
      title: ConnectorNodeView
      description: One owned node, its live state, and its advanced direct URL.
    ConnectorView:
      properties:
        entitled:
          type: boolean
          title: Entitled
        account_connector:
          type: boolean
          title: Account Connector
        mcp_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcp Url
        client_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Client Id
        client_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Client Name
        node:
          anyOf:
          - $ref: '#/components/schemas/ConnectorNodeView'
          - type: 'null'
        advanced_node_connectors:
          items:
            $ref: '#/components/schemas/ConnectorNodeView'
          type: array
          title: Advanced Node Connectors
      additionalProperties: false
      type: object
      required:
      - entitled
      - account_connector
      - mcp_url
      - client_id
      - client_name
      - node
      - advanced_node_connectors
      title: ConnectorView
      description: 'What a person has to type into Claude, read from this deployment.


        Every field is nullable for the same reason: the ``/claude`` page must

        never print a plausible-looking instruction that this server would refuse.

        No registered client under

        :attr:`~nerdit_cloud.config.Settings.mcp_connector_client_id` means the

        identifier would be rejected at ``/oauth/authorize``; no Remote Link

        entitlement means the consent screen would refuse the grant no matter what

        was pasted. In both cases the page says so instead of showing a value.


        The account gateway URL does not wait for a node: an entitled account gets

        :attr:`mcp_url` with the gateway on even before its first machine, so the

        console can put "connect your agent" first (2026-09-29). The consent

        screen still refuses with 409 until a machine exists. Only a deployment

        with the gateway dark needs a node, because the URL it recommends is that

        node''s own.


        :attr:`account_connector` is the same rule applied to *which* URL is

        recommended, and it is why the recommendation is a server answer rather

        than a page constant: ``/mcp`` answers 503 while

        :attr:`~nerdit_cloud.config.Settings.account_mcp_gateway_enabled` is off,

        so a deployment with the gateway dark recommends the direct node connector

        it does serve.'
    AccountConsentNodeView:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        slug:
          type: string
          title: Slug
        display_name:
          type: string
          title: Display Name
        selected:
          type: boolean
          title: Selected
      additionalProperties: false
      type: object
      required:
      - id
      - slug
      - display_name
      - selected
      title: AccountConsentNodeView
      description: One selectable account-gateway destination and its initial state.
    NodeAuthorizeContextView:
      properties:
        client_id:
          type: string
          title: Client Id
        client_name:
          type: string
          title: Client Name
        self_registered:
          type: boolean
          title: Self Registered
        role:
          type: string
          const: submitter
          title: Role
        scopes:
          items:
            type: string
          type: array
          title: Scopes
        redirect_uri:
          type: string
          title: Redirect Uri
        resource_kind:
          type: string
          const: node
          title: Resource Kind
        node:
          $ref: '#/components/schemas/ConsentNodeView'
        already_consented:
          type: boolean
          title: Already Consented
      additionalProperties: false
      type: object
      required:
      - client_id
      - client_name
      - self_registered
      - role
      - scopes
      - redirect_uri
      - resource_kind
      - node
      - already_consented
      title: NodeAuthorizeContextView
      description: A consent question for one direct node connector.
    AuthorizeDecisionView:
      properties:
        redirect_to:
          type: string
          title: Redirect To
      additionalProperties: false
      type: object
      required:
      - redirect_to
      title: AuthorizeDecisionView
      description: Where the browser goes next, built only from the registered URI.
    ErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      additionalProperties: false
      type: object
      required:
      - error
      title: ErrorEnvelope
      description: Response model used by all cloud API errors.