HORIZON SHIELD · OpenAPI Overlay 1.0.0

API Evangelist enhancements — HORIZON SHIELD MCP conduct register

27 actions 27 updates documentation extends horizonshield-dev-mcp-conduct-register-openapi.json

Generated by API Evangelist Written by API Evangelist tooling for HORIZON SHIELD's API. It is a proposal applied on top of the contract, not a document HORIZON SHIELD publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

tagsoperationIdx-apievangelistsecurityresponses

Targets 27 · first 16 shown; the file carries all of them

$.info

$.paths['/register'].get

$.paths['/verified.json'].get

$.paths['/history'].get

$.paths['/changes'].get

$.paths['/feed.xml'].get

$.paths['/sitemap.xml'].get

$.paths['/e/{host}{path}'].get

$.paths['/badge'].get

$.paths['/embed'].get

$.paths['/badge/seal'].get

$.paths['/spec'].get

$.paths['/ext/conduct/v1'].get

$.paths['/self'].get

$.paths['/health'].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements — HORIZON SHIELD MCP conduct register
  version: 1.0.0
  x-generated: '2026-09-19'
  x-method: generated
  x-source: openapi/horizonshield-dev-mcp-conduct-register-openapi.json
  x-note: >-
    Non-destructive overlay. The original spec (verbatim from https://gate.horizonshield.dev/openapi.json, OpenAPI
    3.1.0, version 0.4.7) declares no operationIds, no tags, no schemas, no error responses and no security. This
    overlay adds stable operationIds, tags grouped by capability, an explicit empty security array (the API is
    anonymous, as its own description states), links to the provider's discovery documents, and the observed 400/404
    error envelopes. It never edits the provider's own fields.
extends: horizonshield-dev-mcp-conduct-register-openapi.json
actions:
- target: $.info
  update:
    x-apievangelist:
      provider: horizonshield-dev
      website: https://shield.the-horizons-innovation.com/
      agent_card: https://gate.horizonshield.dev/.well-known/agent-card.json
      conduct_extension: https://gate.horizonshield.dev/ext/conduct/v1
      security_txt: https://gate.horizonshield.dev/.well-known/security.txt
      jwks: https://gate.horizonshield.dev/.well-known/jwks.json
      mcp_endpoint: https://gate.horizonshield.dev/mcp
      a2a_endpoint: https://gate.horizonshield.dev/a2a
      client_library: https://www.npmjs.com/package/mcp-conduct
- target: $
  update:
    security: []
    tags:
    - {name: register, description: The public register of measured MCP endpoints and its feeds}
    - {name: measurement, description: Requesting and reading measurements of one endpoint}
    - {name: verification, description: Recomputing verdict hashes and signatures}
    - {name: badges, description: Badges and embeddable verification envelopes}
    - {name: meta, description: The gate's own conditions, health, self-measurement and discovery}
- target: $.paths['/register'].get
  update: {operationId: listRegister, tags: [register]}
- target: $.paths['/verified.json'].get
  update: {operationId: listVerified, tags: [register]}
- target: $.paths['/history'].get
  update: {operationId: getEndpointHistory, tags: [measurement]}
- target: $.paths['/changes'].get
  update: {operationId: listChanges, tags: [register]}
- target: $.paths['/feed.xml'].get
  update: {operationId: getChangesAtom, tags: [register]}
- target: $.paths['/sitemap.xml'].get
  update: {operationId: getSitemap, tags: [register]}
- target: $.paths['/e/{host}{path}'].get
  update: {operationId: getEndpointPage, tags: [register]}
- target: $.paths['/badge'].get
  update: {operationId: getBadge, tags: [badges]}
- target: $.paths['/embed'].get
  update: {operationId: getEmbed, tags: [badges]}
- target: $.paths['/badge/seal'].get
  update: {operationId: getBadgeSeal, tags: [badges]}
- target: $.paths['/spec'].get
  update: {operationId: getConditions, tags: [meta]}
- target: $.paths['/ext/conduct/v1'].get
  update: {operationId: getConductExtension, tags: [meta]}
- target: $.paths['/self'].get
  update: {operationId: getSelfMeasurement, tags: [meta]}
- target: $.paths['/health'].get
  update: {operationId: getHealth, tags: [meta]}
- target: $.paths['/recompute'].post
  update: {operationId: recomputeHash, tags: [verification]}
- target: $.paths['/verify-event'].post
  update: {operationId: verifyNostrEvent, tags: [verification]}
- target: $.paths['/mould'].get
  update: {operationId: listMould, tags: [meta]}
- target: $.paths['/sweep/last'].get
  update: {operationId: getLastSweep, tags: [meta]}
- target: $.paths['/nenrin/window'].get
  update: {operationId: getNenrinWindow, tags: [meta]}
- target: $.paths['/register/lookup'].get
  update:
    operationId: lookupEndpoint
    tags: [measurement]
    responses:
      '400': {description: 'endpoint (https URL) required — observed: {"error":"endpoint (https URL) required","example":"/register/lookup?endpoint=https%3A%2F%2Fmcp.horizonshield.dev%2Fmcp"}'}
- target: $.paths['/watchlist'].get
  update: {operationId: listWatchlist, tags: [register]}
- target: $.paths['/.well-known/agent-card.json'].get
  update: {operationId: getAgentCard, tags: [meta]}
- target: $.paths['/.well-known/mcp-register.json'].get
  update: {operationId: getRegisterSummary, tags: [register]}
- target: $.paths['/check'].post
  update: {operationId: checkEndpoint, tags: [measurement]}
- target: $.paths['/mcp'].post
  update: {operationId: mcpJsonRpc, tags: [meta]}