---
title: "List MCP endpoints"
method: GET
path: "/api/mcp_endpoints"
tags: ["MCP endpoints"]
---

# List MCP endpoints

`GET /api/mcp_endpoints`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/mcp_endpoints`
- Auth: API key in header `x-api-key`

Each endpoint names this environment in an MCP server URL by its id. The MCP client authenticates the caller with OAuth.

## Response `200`

The environment's endpoints

- object
  - `endpoints` McpEndpointSchema[]
    - `created` string, date-time
    - `heron_id` string
    - `label` string: Human-readable label for this endpoint
    - `request_secret_required` boolean: Whether MCP requests must carry the endpoint's request secret

## Changes

- **2026-11-03** `bd8008e49534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/mcp_endpoints/get.md)

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/1ec936e17fef?raw)