HEherondata
MCP endpoints

Create an MCP endpoint

Changed on

Creates an endpoint for this environment. Its id becomes part of the MCP server URL. With require_request_secret, the response carries a secret, shown once, that every MCP request to the endpoint must send in the X-Auth-Token header.

post/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

Request body

labelstring required

Human-readable label for this endpoint

require_request_secretboolean

Issue a secret that every MCP request to this endpoint must carry in its X-Auth-Token header. It is returned once, in this response.

Response

Endpoint created

createdstring date-time
heron_idstring
labelstring

Human-readable label for this endpoint

request_secretstring

Present only when requested. Shown once; Heron stores only its digest.

request_secret_requiredboolean

Whether MCP requests must carry the endpoint's request secret

Changes