Hyperresearch · OAuth Scopes

Hyperresearch OAuth Scopes

OAuth 2.0 derived

Hyperresearch publishes 8 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Hyperresearch API on a user’s behalf.

Tokens are issued from https://api.hyperresearch.ai/oauth/token.

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.

Artificial IntelligenceSearchResearchData

Scopes: 8 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://api.hyperresearch.ai/oauth/authorize

Token URL
https://api.hyperresearch.ai/oauth/token

Flows
authorizationCode

Scopes (8)

Scope	Description	Flows
answers:ask	Answers: `ask` and `search` calls billed per call from the prepaid wallet, plus reading the wallet balance (billable).	authorizationCode
fetch	Fetch a URL into the vault on the workspace’s budget (billable; OAuth grants only, checked against the member’s role).	authorizationCode
mcp	Connect to the hosted MCP server; every OAuth grant carries it.	authorizationCode
runs:read	Read runs: status, event stream, results, reports and artifacts.	authorizationCode
runs:write	Start, clarify, pause, resume, abort and re-run research runs (billable).	authorizationCode
vault:read	Read and search the workspace vault: notes, claims, sources, hubs, escalations, scholar lookups.	authorizationCode
vault:write	Write to the workspace vault: create/update/delete notes, ingest claims, import, resolve escalations.	authorizationCode
verify	Run citation, quote, retraction and independence verification jobs and read their results (billable).	authorizationCode

📄 Provider scope reference:

Source

OAuth Scopes

generated: '2026-11-12'
method: derived
source: openapi/hyperresearch-ai-openapi.json
schemes:
- name: oauth2
  source: openapi/hyperresearch-ai-openapi.json
  flows:
  - flow: authorizationCode
    authorizationUrl: https://api.hyperresearch.ai/oauth/authorize
    tokenUrl: https://api.hyperresearch.ai/oauth/token
  description: 'OAuth 2.1 for agents (MCP clients): authorization code with PKCE (S256), public
    clients, dynamic client registration at `https://api.hyperresearch.ai/oauth/register`, discovery
    at `https://api.hyperresearch.ai/.well-known/oauth-authorization-server`. Access tokens
    (15 min) and rotating refresh tokens (30 days) are bound to the resource `https://mcp.hyperresearch.ai/mcp`
    and are accepted by the hosted MCP server, not by the REST operations in this document,
    which take an API key (`bearerAuth`). A member can only delegate scopes their workspace
    role holds; the token response reports the granted `scope`.'
scopes:
- scope: answers:ask
  description: 'Answers: `ask` and `search` calls billed per call from the prepaid wallet, plus
    reading the wallet balance (billable).'
  flows:
  - authorizationCode
  sources:
  - openapi/hyperresearch-ai-openapi.json
- scope: fetch
  description: Fetch a URL into the vault on the workspace’s budget (billable; OAuth grants
    only, checked against the member’s role).
  flows:
  - authorizationCode
  sources:
  - openapi/hyperresearch-ai-openapi.json
- scope: mcp
  description: Connect to the hosted MCP server; every OAuth grant carries it.
  flows:
  - authorizationCode
  sources:
  - openapi/hyperresearch-ai-openapi.json
- scope: runs:read
  description: 'Read runs: status, event stream, results, reports and artifacts.'
  flows:
  - authorizationCode
  sources:
  - openapi/hyperresearch-ai-openapi.json
- scope: runs:write
  description: Start, clarify, pause, resume, abort and re-run research runs (billable).
  flows:
  - authorizationCode
  sources:
  - openapi/hyperresearch-ai-openapi.json
- scope: vault:read
  description: 'Read and search the workspace vault: notes, claims, sources, hubs, escalations,
    scholar lookups.'
  flows:
  - authorizationCode
  sources:
  - openapi/hyperresearch-ai-openapi.json
- scope: vault:write
  description: 'Write to the workspace vault: create/update/delete notes, ingest claims, import,
    resolve escalations.'
  flows:
  - authorizationCode
  sources:
  - openapi/hyperresearch-ai-openapi.json
- scope: verify
  description: Run citation, quote, retraction and independence verification jobs and read their
    results (billable).
  flows:
  - authorizationCode
  sources:
  - openapi/hyperresearch-ai-openapi.json

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/hyperresearch-ai-scopes"

All oauth scopes

curl "https://apis.io/api/v1/scopes?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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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