Skip to main content
Glama

create_endpoint

Create an endpoint under a line. Defaults to immediate publish; draft mode requires draftRevision. scheduledAt stages the line draft then schedules it. Requires edit access.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
lineKeyYesThe line key to create the endpoint under.
endpointYesAn EchoRelay endpoint. Round-trips with the JSON returned by get_endpoint.
commitModeNoDefaults to publish. Draft writes require draftRevision.
scheduledAtNoCompatibility alias: stage this endpoint in its line draft then schedule that line.
draftRevisionNoCurrent line draft revision, required for draft writes.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / endpoint / properties / targets / items / properties / signingSecret
      Added value: +{
      +  "description": "Signs the body delivered to this target — separate from auth above, which authenticates OUTBOUND to the target. Shape: \"whsec_\" followed by base64 of 32 random bytes. Omit to leave unchanged; set to null to disable signing; set to your own whsec_-shaped value to use it verbatim (rejected otherwise, including an empty string — you hold this secret, so only you can supply it). On reads, a configured secret is redacted to \"***\" — round-trip that sentinel to keep the stored secret.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  2. Changed1 schema field changed
    • addedInput schema / properties / endpoint / properties / targets / items / properties / callbackURL
      Added value: +{
      +  "description": "Pushed once this target's delivery reaches a terminal status — see get_receipts' callbackState. Must be https. Meaningful for async targets only — refused on sync/stream. Cannot point back into this project (the same relay-loop rule as targetUrl) and must be inside the project's outbound host allowlist when one is set. Unset = the customer polls the receipt instead.",
      +  "format": "uri",
      +  "type": "string"
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / endpoint / properties / targets / items / properties / answerVariants / description
      Previous value: -"The conditional form of answerMapping, for a target whose answers do not all share one shape: one mapping per reply instead of one for every reply. Requires \"distinguishBy\" naming the single thing that tells them apart ({\"source\":\"status\"}, {\"source\":\"header\",\"name\":…} or {\"source\":\"bodyField\",\"path\":…}), \"variants\" as an object keyed by the value it matches — an exact status like \"429\", a class like \"4XX\", or \"default\" — each holding a tree in the same grammar as answerMapping, and \"onNoMatch\", which has no default and must be either \"passthrough\" (hand the vendor's answer back untouched) or \"fail\" (answer 422 naming the value that matched nothing). Mutually exclusive with answerMapping on this target, and refused on a stream target for the same reason answerMapping is. A variant whose tree does not compile is refused when the line is published, not silently dropped. null = no reshaping."New value: +"The conditional form of answerMapping, for a target whose answers do not all share one shape: one mapping per reply instead of one for every reply. Requires \"distinguishBy\" naming the single thing that tells them apart ({\"source\":\"status\"}, {\"source\":\"header\",\"name\":…} or {\"source\":\"bodyField\",\"path\":…}), \"variants\" as an object keyed by the value it matches — an exact status like \"429\", a class like \"4XX\", or \"default\" — each holding a tree in the same grammar as answerMapping — or, where the caller should be answered with a status of your own, an object {\"mapping\": <tree>, \"replyStatus\": 402} — and \"onNoMatch\", which has no default and must be either \"passthrough\" (hand the vendor's answer back untouched) or \"fail\" (answer 422 naming the value that matched nothing). A replyStatus is what the caller sees and never what the delivery is measured or charged as; it must be a status that can carry a body (200–599, excluding 204, 205 and redirects), and setting one drops the vendor's own response headers, which describe the answer it replaced. A variant keyed on a status that carries no body (204, 205, 304) is reachable only when it sets one. Mutually exclusive with answerMapping on this target, and refused on a stream target for the same reason answerMapping is. A variant whose tree does not compile is refused when the line is published, not silently dropped. null = no reshaping."
  4. Changed1 schema field changed
    • addedInput schema / properties / endpoint / properties / attributes / items / properties / forwarding
      Added value: +{
      +  "description": "Only meaningful for in=query or in=path. blocked (default): validated, never sent to the target. forwardInPlace: sent to the target in the same location — a query attribute as a query parameter, a path attribute as a path segment. A path attribute forwards only when its name is its own zero-based segment position (\"0\" for the first segment after the endpoint URL, \"1\" for the next, …) — path segments are matched positionally, not by name. To carry a value into the body or a header instead, leave this blocked and add a field mapping on the target sourced from this attribute.",
      +  "enum": [
      +    "blocked",
      +    "forwardInPlace"
      +  ],
      +  "type": "string"
      +}
  5. Changed1 schema field changed
    • addedInput schema / properties / endpoint / properties / targets / items / properties / answerVariants
      Added value: +{
      +  "description": "The conditional form of answerMapping, for a target whose answers do not all share one shape: one mapping per reply instead of one for every reply. Requires \"distinguishBy\" naming the single thing that tells them apart ({\"source\":\"status\"}, {\"source\":\"header\",\"name\":…} or {\"source\":\"bodyField\",\"path\":…}), \"variants\" as an object keyed by the value it matches — an exact status like \"429\", a class like \"4XX\", or \"default\" — each holding a tree in the same grammar as answerMapping, and \"onNoMatch\", which has no default and must be either \"passthrough\" (hand the vendor's answer back untouched) or \"fail\" (answer 422 naming the value that matched nothing). Mutually exclusive with answerMapping on this target, and refused on a stream target for the same reason answerMapping is. A variant whose tree does not compile is refused when the line is published, not silently dropped. null = no reshaping.",
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
  6. Changed2 schema fields changed
    • addedInput schema / properties / endpoint / properties / targets / items / properties / answerMapping
      Added value: +{
      +  "description": "Reshapes this target's answer into what the caller receives — a tree of typed nodes conforming to the same published grammar as outgoingMapping. Refused on a stream target (deliveryMode=stream) — a stream's response is proxied straight through and never reshaped. null = no reshaping, the answer reaches the caller verbatim; paths, types and cycles are checked server-side.",
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / endpoint / properties / targets / items / properties / outgoingMapping
      Added value: +{
      +  "description": "Reshapes the request into what this target expects — a tree of typed nodes conforming to the published grammar at \"https://schemas.echorelay.dev/transform/mapping/v1.json\" (its own $schema key must name that value). Mutually exclusive with mapping and transformers on this target, and with the endpoint's own transformers — the write is rejected if both are set. null = no reshaping (today's behaviour, and the only value this schema itself can validate; paths, types and cycles are checked server-side).",
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
  7. Changed4 schema fields changed
    • changedInput schema / properties / endpoint / properties / targets / items / properties / retryPolicy / description
      Previous value: -"Async retry policy. Ignored unless deliveryMode=async. Leave it unset (null) and the platform's own default ladder applies instead — it is not expressible through this schema and runs considerably longer than any maxAttempts you can set here, so a target left on defaults can sit quietly for a long time before anything reaches the DLQ. Set it explicitly — a low maxAttempts included — for a retry ladder you can predict and observe. get_endpoint reports which is in effect: this object when set, null when the platform default applies."New value: +"Async retry policy. Ignored unless deliveryMode=async. Leave it unset (null) and the platform default applies, which behaves the same as maxAttempts at its maximum. get_endpoint reports which is in effect: this object when set, null when the platform default applies."
    • addedInput schema / properties / endpoint / properties / targets / items / properties / retryPolicy / properties / backoffMultiplier / description
      Added value: +"How sharply the gap between tries widens. Higher spends the same attempts over a longer stretch. Defaults to 2.0."
    • changedInput schema / properties / endpoint / properties / targets / items / properties / retryPolicy / properties / maxAttempts / description
      Previous value: -"Including the initial attempt. Only takes effect when retryPolicy itself is set — see its description for what an unset retryPolicy uses instead."New value: +"Total delivery attempts, counting the first. 1 fails fast: one try, then the dead-letter queue. Higher values keep retrying with a widening gap between tries — at the default backoffMultiplier, roughly under a minute at 4, a few minutes at 7, about an hour at 10, a few hours at 14. Anything still undelivered lands in the dead-letter queue. Defaults to 14."
    • changedInput schema / properties / endpoint / properties / targets / items / properties / retryPolicy / properties / maxAttempts / maximum
      Previous value: -10New value: +14
  8. Changed2 schema fields changed
    • changedInput schema / properties / endpoint / properties / targets / items / properties / retryPolicy / description
      Previous value: -"Async retry policy. Ignored unless deliveryMode=async."New value: +"Async retry policy. Ignored unless deliveryMode=async. Leave it unset (null) and the platform's own default ladder applies instead — it is not expressible through this schema and runs considerably longer than any maxAttempts you can set here, so a target left on defaults can sit quietly for a long time before anything reaches the DLQ. Set it explicitly — a low maxAttempts included — for a retry ladder you can predict and observe. get_endpoint reports which is in effect: this object when set, null when the platform default applies."
    • changedInput schema / properties / endpoint / properties / targets / items / properties / retryPolicy / properties / maxAttempts / description
      Previous value: -"Including the initial attempt."New value: +"Including the initial attempt. Only takes effect when retryPolicy itself is set — see its description for what an unset retryPolicy uses instead."
  9. Changed2 schema fields changed
    • addedInput schema / properties / endpoint / properties / targets / items / properties / transformers
      Added value: +{
      +  "description": "Request transformation pipeline applied to this target before delivery. Empty array = no transformation.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "params": {
      +        "additionalProperties": false,
      +        "description": "Only the keys the chosen type reads are accepted; see the type description above.",
      +        "properties": {
      +          "field": {
      +            "description": "Target field — removeField / mapValue.",
      +            "type": "string"
      +          },
      +          "from": {
      +            "description": "mergeFields (all sources) / renameField (first element is the source).",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "mapping": {
      +            "additionalProperties": {
      +              "type": "string"
      +            },
      +            "description": "Value lookup table — mapValue.",
      +            "type": "object"
      +          },
      +          "maxSizeMB": {
      +            "description": "Max upload size in MB — binaryToUrl.",
      +            "minimum": 1,
      +            "type": "integer"
      +          },
      +          "separator": {
      +            "description": "Join separator — mergeFields (default \" \").",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Destination field — mergeFields / renameField / addField.",
      +            "type": "string"
      +          },
      +          "ttlSeconds": {
      +            "description": "Temp file lifetime in seconds — binaryToUrl.",
      +            "minimum": 1,
      +            "type": "integer"
      +          },
      +          "value": {
      +            "description": "Constant value to set — addField.",
      +            "type": "string"
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": {
      +        "description": "mergeFields: from+to(+separator). renameField: from+to. removeField: field. addField: to+value. mapValue: field+mapping. binaryToUrl: ttlSeconds?+maxSizeMB? (both clamped server-side — omit for the server default).",
      +        "enum": [
      +          "mergeFields",
      +          "renameField",
      +          "removeField",
      +          "addField",
      +          "mapValue",
      +          "binaryToUrl"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / endpoint / properties / transformers
      Added value: +{
      +  "description": "Endpoint-level request transformation pipeline, applied before any target-level transformers. Set to null to remove the override and inherit the line default (if the line has one); set to an empty array to explicitly apply no transformation even when the line has a default. Omit on update_endpoint to leave the existing value unchanged.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "params": {
      +        "additionalProperties": false,
      +        "description": "Only the keys the chosen type reads are accepted; see the type description above.",
      +        "properties": {
      +          "field": {
      +            "description": "Target field — removeField / mapValue.",
      +            "type": "string"
      +          },
      +          "from": {
      +            "description": "mergeFields (all sources) / renameField (first element is the source).",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "mapping": {
      +            "additionalProperties": {
      +              "type": "string"
      +            },
      +            "description": "Value lookup table — mapValue.",
      +            "type": "object"
      +          },
      +          "maxSizeMB": {
      +            "description": "Max upload size in MB — binaryToUrl.",
      +            "minimum": 1,
      +            "type": "integer"
      +          },
      +          "separator": {
      +            "description": "Join separator — mergeFields (default \" \").",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Destination field — mergeFields / renameField / addField.",
      +            "type": "string"
      +          },
      +          "ttlSeconds": {
      +            "description": "Temp file lifetime in seconds — binaryToUrl.",
      +            "minimum": 1,
      +            "type": "integer"
      +          },
      +          "value": {
      +            "description": "Constant value to set — addField.",
      +            "type": "string"
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": {
      +        "description": "mergeFields: from+to(+separator). renameField: from+to. removeField: field. addField: to+value. mapValue: field+mapping. binaryToUrl: ttlSeconds?+maxSizeMB? (both clamped server-side — omit for the server default).",
      +        "enum": [
      +          "mergeFields",
      +          "renameField",
      +          "removeField",
      +          "addField",
      +          "mapValue",
      +          "binaryToUrl"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  "type": [
      +    "array",
      +    "null"
      +  ]
      +}
  10. Changed4 schema fields changed
    • addedInput schema / properties / commitMode
      Added value: +{
      +  "description": "Defaults to publish. Draft writes require draftRevision.",
      +  "enum": [
      +    "draft",
      +    "publish"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / draftRevision
      Added value: +{
      +  "description": "Current line draft revision, required for draft writes.",
      +  "type": "integer"
      +}
    • changedInput schema / properties / endpoint / properties / httpMethod / description
      Previous value: -"HTTP method callers must use."New value: +"HTTP method callers must use. GET endpoints cannot declare a body attribute (see attributes[].in)."
    • changedInput schema / properties / scheduledAt / description
      Previous value: -"Optional ISO-8601 time between 2 minutes and 7 days from now. When present, save the endpoint into a frozen scheduled publish instead of publishing now."New value: +"Compatibility alias: stage this endpoint in its line draft then schedule that line."
  11. Changed1 schema field changed
    • changedInput schema / properties / scheduledAt / description
      Previous value: -"Optional ISO-8601 time within 7 days. When present, save the endpoint into a frozen scheduled publish instead of publishing now."New value: +"Optional ISO-8601 time between 2 minutes and 7 days from now. When present, save the endpoint into a frozen scheduled publish instead of publishing now."
  12. Changed1 schema field changed
    • addedInput schema / properties / scheduledAt
      Added value: +{
      +  "description": "Optional ISO-8601 time within 7 days. When present, save the endpoint into a frozen scheduled publish instead of publishing now.",
      +  "type": "string"
      +}
  13. Changed1 schema field changed
    • changedInput schema / properties / endpoint / properties / targets / items / properties / credentialVaultEntryId / description
      Previous value: -"References a saved credential (see list_credentials/create_credential) instead of inline auth — the auth field above is ignored when this is set. Must belong to the same project."New value: +"References a saved credential (see list_credentials/create_credential) instead of inline auth — the auth field above is ignored when this is set. Must belong to the same project. The credential is bound to a destination when it is created: targetUrl must be https and its host must match that credential's destinationHost, or the write is rejected."
  14. Changed7 schema fields changed
    • changedInput schema / properties / endpoint / properties / targets / items / properties / auth / description
      Previous value: -"Outbound auth applied to the request. On reads, secrets are redacted to \"***\" — round-trip the sentinel to keep the stored secret."New value: +"Outbound auth applied to the request. On reads, secrets are redacted to \"***\" — round-trip the sentinel to keep the stored secret. Ignored when credentialVaultEntryId is set."
    • addedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / headerName
      Added value: +{
      +  "description": "Required when type=apiKeyHeader.",
      +  "type": "string"
      +}
    • addedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / key
      Added value: +{
      +  "description": "Required when type=apiKeyHeader or type=apiKeyQuery or type=publicPrivateKey.",
      +  "type": "string"
      +}
    • addedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / paramName
      Added value: +{
      +  "description": "Required when type=apiKeyQuery.",
      +  "type": "string"
      +}
    • addedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / secret
      Added value: +{
      +  "description": "Required when type=publicPrivateKey.",
      +  "type": "string"
      +}
    • changedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / type / enum
      Previous value: -[
      -  "none",
      -  "bearer",
      -  "basic"
      -]New value: +[
      +  "none",
      +  "bearer",
      +  "basic",
      +  "apiKeyHeader",
      +  "apiKeyQuery",
      +  "publicPrivateKey"
      +]
    • addedInput schema / properties / endpoint / properties / targets / items / properties / credentialVaultEntryId
      Added value: +{
      +  "description": "References a saved credential (see list_credentials/create_credential) instead of inline auth — the auth field above is ignored when this is set. Must belong to the same project.",
      +  "type": "string"
      +}
  15. Changed7 schema fields changed
    • changedInput schema / properties / endpoint / properties / targets / items / properties / auth / description
      Previous value: -"Outbound auth applied to the request. On reads, secrets are redacted to \"***\" — round-trip the sentinel to keep the stored secret. Ignored when credentialVaultEntryId is set."New value: +"Outbound auth applied to the request. On reads, secrets are redacted to \"***\" — round-trip the sentinel to keep the stored secret."
    • removedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / headerName
      Removed value: -{
      -  "description": "Required when type=apiKeyHeader.",
      -  "type": "string"
      -}
    • removedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / key
      Removed value: -{
      -  "description": "Required when type=apiKeyHeader or type=apiKeyQuery or type=publicPrivateKey.",
      -  "type": "string"
      -}
    • removedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / paramName
      Removed value: -{
      -  "description": "Required when type=apiKeyQuery.",
      -  "type": "string"
      -}
    • removedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / secret
      Removed value: -{
      -  "description": "Required when type=publicPrivateKey.",
      -  "type": "string"
      -}
    • changedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / type / enum
      Previous value: -[
      -  "none",
      -  "bearer",
      -  "basic",
      -  "apiKeyHeader",
      -  "apiKeyQuery",
      -  "publicPrivateKey"
      -]New value: +[
      +  "none",
      +  "bearer",
      +  "basic"
      +]
    • removedInput schema / properties / endpoint / properties / targets / items / properties / credentialVaultEntryId
      Removed value: -{
      -  "description": "References a saved credential (see list_credentials/create_credential) instead of inline auth — the auth field above is ignored when this is set. Must belong to the same project.",
      -  "type": "string"
      -}
  16. Changed7 schema fields changed
    • changedInput schema / properties / endpoint / properties / targets / items / properties / auth / description
      Previous value: -"Outbound auth applied to the request. On reads, secrets are redacted to \"***\" — round-trip the sentinel to keep the stored secret."New value: +"Outbound auth applied to the request. On reads, secrets are redacted to \"***\" — round-trip the sentinel to keep the stored secret. Ignored when credentialVaultEntryId is set."
    • addedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / headerName
      Added value: +{
      +  "description": "Required when type=apiKeyHeader.",
      +  "type": "string"
      +}
    • addedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / key
      Added value: +{
      +  "description": "Required when type=apiKeyHeader or type=apiKeyQuery or type=publicPrivateKey.",
      +  "type": "string"
      +}
    • addedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / paramName
      Added value: +{
      +  "description": "Required when type=apiKeyQuery.",
      +  "type": "string"
      +}
    • addedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / secret
      Added value: +{
      +  "description": "Required when type=publicPrivateKey.",
      +  "type": "string"
      +}
    • changedInput schema / properties / endpoint / properties / targets / items / properties / auth / properties / type / enum
      Previous value: -[
      -  "none",
      -  "bearer",
      -  "basic"
      -]New value: +[
      +  "none",
      +  "bearer",
      +  "basic",
      +  "apiKeyHeader",
      +  "apiKeyQuery",
      +  "publicPrivateKey"
      +]
    • addedInput schema / properties / endpoint / properties / targets / items / properties / credentialVaultEntryId
      Added value: +{
      +  "description": "References a saved credential (see list_credentials/create_credential) instead of inline auth — the auth field above is ignored when this is set. Must belong to the same project.",
      +  "type": "string"
      +}
  17. First observed

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only say readOnlyHint=false and destructiveHint=false. The description adds the important extras: edit access is required, publish is the default side effect, and scheduledAt reaches beyond the endpoint to stage and schedule the parent line draft — a non-obvious cross-resource effect.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four short clauses, zero filler, and the most decision-relevant fact (default publish) is front-loaded right after the purpose statement.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a deeply nested create tool the description covers the mode/auth semantics an agent needs before invoking, and the endpoint payload itself is exhaustively documented in the schema. It omits nothing critical, though the interplay with scheduling siblings could be spelled out further.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all five params including commitMode and draftRevision. The description largely restates those schema descriptions and adds no new syntax or format detail, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource plus its scope: 'Create an endpoint under a line.' That is unambiguous and distinguishable from update_endpoint/delete_endpoint by plain meaning, but the description never names a sibling tool, so it stops short of 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives real context on which mode applies: publish is the default, draft requires draftRevision, and scheduledAt stages the line draft before scheduling. It does not point to alternatives (update_endpoint for existing endpoints, default_endpoint_template, discard_draft_endpoint), so no explicit when-not guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources