Relevance AI · OAuth Scopes

Relevance AI OAuth Scopes

OAuth 2.0 probed

Relevance AI uses OAuth 2.0 but publishes no discrete scopes — access is governed by the grant itself (e.g. client-credentials or role-based authorization) rather than per-scope consent.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

AI AgentsAI AutomationMulti-Agent SystemsAgent PlatformMCPagent-nativeWorkflow-AutomationLLM OrchestrationKnowledge-ManagementObservabilitySales AutomationGTM Engineering
Scopes: 0 Flows: Method: probed

Scopes (0)

Relevance AI implements OAuth 2.0 but publishes no discrete scopes — access is governed by the grant itself (client-credentials or role-based authorization) rather than per-scope consent.

Source

OAuth Scopes

Raw ↑
generated: '2026-08-29'
method: probed
source: >-
  https://mcp.relevanceai.com/.well-known/oauth-authorization-server,
  https://mcp.relevanceai.com/.well-known/oauth-protected-resource,
  https://relevanceai.com/docs/integrations/mcp/mcp-server
provider: Relevance AI
providerId: relevance-ai
description: >-
  The REST API declares no oauth2 security scheme — it authenticates with a static
  `Authorization: project:api_key` header and has no scope concept at all. The only OAuth
  surface is the MCP server, and its scope model is deliberately coarse: one scope, with real
  authorization carried by the caller's project role rather than by scope strings.
rest_api:
  oauth2: false
  scopes: []
  detail: >-
    derive-oauth-scopes.py over openapi/relevance-ai-openapi.json found 0 oauth2 flows across
    566 operations. The single securityScheme is apiKey in header. An API key grants
    unrestricted access to every resource in its project — the docs say so explicitly — so
    there is no way to issue a least-privilege REST credential.
mcp:
  authorization_server: https://mcp.relevanceai.com/
  scopes_supported:
    - name: claudeai
      description: >-
        The only scope the authorization server advertises, in both the authorization-server
        and protected-resource metadata. It carries no capability semantics.
  grant_types: [authorization_code, refresh_token]
  pkce: S256
  dynamic_client_registration: true
  effective_authorization:
    model: project role, enforced server-side
    detail: >-
      Because there is one scope, the real permission boundary is the caller's Relevance AI
      project role, applied at consent time. Write and destructive tools are REMOVED from the
      tool list server-side for restricted sessions rather than merely hidden client-side.
    roles:
      - role: Admin
        access: full
        can_opt_into_run_only: true
      - role: Editor
        access: full
        can_opt_into_run_only: true
      - role: Member
        access: full
        can_opt_into_run_only: true
      - role: Viewer
        access: run-only
        can_opt_into_run_only: forced
      - role: Chat
        access: chat-only
        can_opt_into_run_only: forced
    consent_toggle: >-
      The OAuth consent screen shows a Run-Only mode toggle for Member, Editor and Admin,
      defaulting to off (full access).
    limitation: >-
      Chat-role users cannot set up dynamic (user-level) OAuth connections via MCP.
  session_scope: one Relevance AI project per authenticated connection
docs: https://relevanceai.com/docs/integrations/mcp/mcp-server#access-control
gaps:
  - REST API keys cannot be scoped or least-privileged; they are all-or-nothing per project.
  - A single OAuth scope means a client cannot request narrower access than its role allows.
  - No scope reference page is published; the scope name was read from the metadata document.

Work with this as data

Every scope set 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 oauth scopes

4 MCP tools reach this
  • find_scopesBrowse and filter every scope set in the catalog.
  • 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 scope set
curl "https://apis.io/api/v1/scopes/relevance-ai-scopes"
All oauth scopes
curl "https://apis.io/api/v1/scopes?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.