Nerdit OAuth API
MCP authorization consent for the signed-in person.
MCP authorization consent for the signed-in person.
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/nerdit-ai:nerdit-ai-oauth-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: 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.