---
title: "Get Claude SDK options schema"
method: GET
path: "/agents/mcp/sdk_options"
tags: ["Agents"]
---

# Get Claude SDK options schema

`GET /agents/mcp/sdk_options`

## Request

- Base URL: `https://h2ogpte.genai.h2o.ai/api/v1`
- URL: `https://h2ogpte.genai.h2o.ai/api/v1/agents/mcp/sdk_options`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/h2o/apis/h2ogpte-rest-api/docs/agents/mcp/sdk_options/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the schema of available Claude SDK options that can be configured for MCP tool runners. Includes permission modes, effort levels, available betas, hook actions, and limitations.

## Response `200`

Successful operation

- object
  - `status` string
  - `sdk_options_schema` object
  - `permission_modes` string[]
  - `effort_levels` string[]
  - `available_betas` string[]
  - `hook_actions` string[]
  - `hook_events` string[]
  - `limitations` object
  - `error` string, nullable

## Other responses

- `400`: Bad request
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error
- `default`: Unexpected error

---

[API](https://skmtc.dev/h2o/apis/h2ogpte-rest-api.md) - [All operations](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/revisions/a82a117320f4?raw)