API Evangelist Governance API

Lint, coverage, waivers, reporting, certification, agent export, pipeline audit, toolsmith, context gate.

Operations 23

POST /governance/validate Lint an API artifact (FREE) #
POST /governance/coverage Governance coverage of a document (FREE) #
POST /governance/waivers Reconcile waivers against lint output (FREE) #
POST /governance/report Render a governance report (FREE HTML, Pro SARIF) #
POST /governance/verify Verify a governance certificate (FREE) #
POST /governance/classify Classify PII and secret fields (FREE) #
POST /governance/diff Detect breaking changes between two versions (FREE) #
POST /governance/scorecard API maturity scorecard (FREE) #
POST /governance/deprecation Deprecation / sunset posture (FREE) #
POST /governance/mock Generate example payloads (PRO) #
POST /governance/snippets Generate code samples (PRO) #
GET /governance/rules The curated rule catalog (FREE) #
GET /governance/rulesets The Ruleset Commons registry (FREE) #
POST /governance/certify Issue a governance certificate (PRO) #
POST /governance/agent-export Export agent-native governance artifacts (PRO) #
POST /governance/pipeline-audit Audit a repo Spectral CI maturity (PRO) #
POST /governance/toolsmith Forge MCP tools and Agent Skills (PRO) #
POST /governance/context-gate Emit a governed agent surface (PRO) #
POST /governance/overlay Apply an OpenAPI Overlay (PRO) #
GET /policies Policies #
GET /policies/{slug} Policy #
GET /rules Rules #
GET /rules/{slug} Rule #

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/api-evangelist-governance-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

api-evangelist-governance-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Evangelist Governance API
  contact:
    name: API Evangelist
    url: https://apievangelist.com
    email: info@apievangelist.com
  version: '1.0'
  description: 'Operations tagged Governance across 2 of this provider''s published API definitions: apievangelist-governance-openapi.json, apievangelist-v1-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.apievangelist.com/v1
  description: Production
tags:
- name: Governance
  description: Lint, coverage, waivers, reporting, certification, agent export, pipeline audit, toolsmith, context gate.
paths:
  /governance/validate:
    post:
      tags:
      - Governance
      summary: Lint an API artifact (FREE)
      description: Lint an OpenAPI, AsyncAPI, Arazzo, or JSON Schema document against the curated 574-rule best-of-breed ruleset (Spectral). Pass your own Spectral ruleset to override the catalog.
      x-tier: free
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - document
              properties:
                document:
                  type: string
                  description: The artifact as YAML or JSON text.
                format:
                  type: string
                  description: Auto-detected when omitted.
                  enum:
                  - openapi
                  - asyncapi
                  - arazzo
                  - jsonschema
                ruleset:
                  type: object
                  description: An optional full Spectral ruleset definition to run instead of the catalog.
                tags:
                  type: array
                  items:
                    type: string
                  description: Only run catalog rules carrying one of these tags.
              example:
                document: "openapi: 3.0.0\ninfo:\n  title: Widget API\n  version: 1.0.0\npaths: {}"
                format: openapi
      responses:
        '200':
          description: Lint result.
          content:
            application/json:
              schema:
                type: object
                properties:
                  format:
                    type: string
                  ruleCount:
                    type: integer
                  passed:
                    type: boolean
                  summary:
                    type: object
                    properties:
                      error:
                        type: integer
                      warning:
                        type: integer
                      info:
                        type: integer
                      hint:
                        type: integer
                      total:
                        type: integer
                  diagnostics:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        message:
                          type: string
                        severity:
                          type: string
                          enum:
                          - error
                          - warning
                          - info
                          - hint
                        path:
                          type: array
                          items:
                            type: string
                        source:
                          type: string
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '400':
          $ref: '#/components/responses/BadRequest'
        '422':
          $ref: '#/components/responses/Unprocessable'
      operationId: validate
      x-mcp-tool: validate_api
      x-agent-skill: api-governance
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/coverage:
    post:
      tags:
      - Governance
      summary: Governance coverage of a document (FREE)
      description: How much of an API description the ruleset actually inspects — coverage by section, dead rules, and each rule reach.
      x-tier: free
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - document
              properties:
                document:
                  type: string
                  description: The API description (YAML or JSON text, or an object).
                format:
                  type: string
                  enum:
                  - openapi
                  - asyncapi
                  - arazzo
                  - jsonschema
                rules:
                  type: array
                  items:
                    type: object
                  description: Rule definitions to measure; defaults to the curated catalog for the format.
                aliases:
                  type: object
                  description: Custom JSONPath alias map.
      responses:
        '200':
          description: Coverage report.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '400':
          $ref: '#/components/responses/BadRequest'
      operationId: coverage
      x-mcp-tool: api_coverage
      x-agent-skill: api-governance
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/waivers:
    post:
      tags:
      - Governance
      summary: Reconcile waivers against lint output (FREE)
      description: Suppress sanctioned violations and surface expired, stale, and expiring waivers — the effective failing set your build should gate on.
      x-tier: free
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - waivers
              - violations
              properties:
                waivers:
                  description: A waivers file (YAML/JSON text) or an array of waiver objects.
                violations:
                  type: array
                  items:
                    type: object
                  description: Spectral lint -f json results.
      responses:
        '200':
          description: Reconciliation result.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '400':
          $ref: '#/components/responses/BadRequest'
      operationId: waivers
      x-mcp-tool: reconcile_waivers
      x-agent-skill: api-governance
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/report:
    post:
      tags:
      - Governance
      summary: Render a governance report (FREE HTML, Pro SARIF)
      description: Turn Spectral findings into a self-contained HTML governance report. Pass ?format=sarif for SARIF 2.1.0 output (Pro).
      x-tier: free
      parameters:
      - name: format
        in: query
        schema:
          type: string
          enum:
          - html
          - sarif
        description: sarif requires a Pro key.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - results
              properties:
                results:
                  type: array
                  items:
                    type: object
                title:
                  type: string
                totals:
                  type: object
                  description: Positive-rule sidecar for the compliance scoreboard.
                dark:
                  type: boolean
      responses:
        '200':
          description: HTML report (text/html) or SARIF log (application/json with ?format=sarif).
          content:
            text/html:
              schema:
                type: string
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '402':
          $ref: '#/components/responses/PaymentRequired'
      operationId: report
      x-mcp-tool: governance_report
      x-agent-skill: api-governance
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/verify:
    post:
      tags:
      - Governance
      summary: Verify a governance certificate (FREE)
      description: Re-verify a tamper-evident API governance certificate against the API it attests to. Consumer-facing trust check.
      x-tier: free
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - certificate
              - api
              properties:
                certificate:
                  type: object
                api:
                  description: The API description object the certificate was issued over.
      responses:
        '200':
          description: Verdict.
          content:
            application/json:
              schema:
                type: object
                properties:
                  verdict:
                    type: string
                    enum:
                    - valid
                    - tampered
                    - expired
                    - not-passed
                    - malformed
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '400':
          $ref: '#/components/responses/BadRequest'
      operationId: verify
      x-mcp-tool: verify_certificate
      x-agent-skill: api-governance
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/classify:
    post:
      tags:
      - Governance
      summary: Classify PII and secret fields (FREE)
      description: Inventory the PII, secret, and sensitive fields an OpenAPI exposes — across parameters and request/response schemas. Uses the same classifiers as Context Gate.
      x-tier: free
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                document:
                  type: string
                  description: A single OpenAPI (YAML/JSON text).
                apis:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                      text:
                        type: string
      responses:
        '200':
          description: Sensitive-field inventory.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '400':
          $ref: '#/components/responses/BadRequest'
      operationId: classify
      x-mcp-tool: classify_api_fields
      x-agent-skill: api-agent-readiness
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/diff:
    post:
      tags:
      - Governance
      summary: Detect breaking changes between two versions (FREE)
      description: Compare two OpenAPI versions and classify every change as breaking, non-breaking, or an addition — at path, operation, parameter, request-body, and response granularity.
      x-tier: free
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - old
              - new
              properties:
                old:
                  description: The previous OpenAPI (YAML/JSON text or object).
                new:
                  description: The new OpenAPI (YAML/JSON text or object).
      responses:
        '200':
          description: Diff result with a compatible flag, summary, and changes[].
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '400':
          $ref: '#/components/responses/BadRequest'
      operationId: diff
      x-mcp-tool: diff_api_versions
      x-agent-skill: api-governance
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/scorecard:
    post:
      tags:
      - Governance
      summary: API maturity scorecard (FREE)
      description: Roll up a 0-100 maturity score with a letter grade across dimensions — design/style (lint), governance coverage, documentation completeness, and (from an apis.json) discoverability, agent-readiness, and operations.
      x-tier: free
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                document:
                  type: string
                  description: An OpenAPI (YAML/JSON text) for the lint/coverage/documentation dimensions.
                apisJson:
                  type: object
                  description: An APIs.json for the discoverability/agent-readiness/operations dimensions.
                format:
                  type: string
                  enum:
                  - openapi
                  - asyncapi
                  - arazzo
                  - jsonschema
      responses:
        '200':
          description: Overall score, grade, and per-dimension breakdown.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '400':
          $ref: '#/components/responses/BadRequest'
      operationId: scorecard
      x-mcp-tool: api_scorecard
      x-agent-skill: api-governance
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/deprecation:
    post:
      tags:
      - Governance
      summary: Deprecation / sunset posture (FREE)
      description: Report every deprecated operation and whether it announces a sunset (x-sunset date or a Sunset/Deprecation response header), plus deprecated schema fields — the honest migration picture.
      x-tier: free
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - document
              properties:
                document:
                  type: string
                  description: An OpenAPI (YAML/JSON text or object).
      responses:
        '200':
          description: Deprecated operations, sunset posture, and deprecated fields.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '400':
          $ref: '#/components/responses/BadRequest'
      operationId: deprecation
      x-mcp-tool: deprecation_posture
      x-agent-skill: api-governance
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/mock:
    post:
      tags:
      - Governance
      summary: Generate example payloads (PRO)
      description: Generate an example request and success-response payload for every operation from its OpenAPI schema (author example/default/enum first, else synthesized by type/format).
      x-tier: pro
      security:
      - ApiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - document
              properties:
                document:
                  type: string
                  description: An OpenAPI (YAML/JSON text or object).
                operationId:
                  type: string
                  description: Only this operation.
                path:
                  type: string
                  description: Only this path.
      responses:
        '200':
          description: Per-operation example request/response payloads.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '402':
          $ref: '#/components/responses/PaymentRequired'
      operationId: mock
      x-mcp-tool: mock_payloads
      x-agent-skill: api-governance
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/snippets:
    post:
      tags:
      - Governance
      summary: Generate code samples (PRO)
      description: Generate runnable curl / JavaScript (fetch) / Python (requests) samples for every operation, with path params filled in and a realistic request body.
      x-tier: pro
      security:
      - ApiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - document
              properties:
                document:
                  type: string
                  description: An OpenAPI (YAML/JSON text or object).
                baseUrl:
                  type: string
                  description: Override the base URL (defaults to servers[0].url).
                authHeader:
                  type: string
                  description: 'Auth header to show, e.g. "Authorization: Bearer $TOKEN" or "x-api-key: $KEY".'
                operationId:
                  type: string
                  description: Only this operation.
                path:
                  type: string
                  description: Only this path.
      responses:
        '200':
          description: Per-operation curl/javascript/python snippets.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '402':
          $ref: '#/components/responses/PaymentRequired'
      operationId: snippets
      x-mcp-tool: code_snippets
      x-agent-skill: api-governance
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/rules:
    get:
      tags:
      - Governance
      summary: The curated rule catalog (FREE)
      x-tier: free
      description: Browse the curated best-of-breed rule catalog the validator runs — every rule with its id, format, title, severity, tags, given, and reference. Optionally filter by artifact format.
      parameters:
      - name: format
        in: query
        schema:
          type: string
          enum:
          - openapi
          - asyncapi
          - arazzo
          - jsonschema
        description: Only rules for this artifact format.
      responses:
        '200':
          description: The rule catalog.
          content:
            application/json:
              schema:
                type: object
                properties:
                  format:
                    type: string
                  count:
                    type: integer
                  rules:
                    type: array
                    items:
                      type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
      operationId: rules
      x-mcp-tool: find_governance_rules
      x-agent-skill: api-governance
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/rulesets:
    get:
      tags:
      - Governance
      summary: The Ruleset Commons registry (FREE)
      x-tier: free
      description: The registry of adoptable, provenanced governance rulesets — national, industry, security, and company rulesets you can extend by reference instead of running the linter defaults.
      responses:
        '200':
          description: The ruleset registry.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
      operationId: rulesets
      x-mcp-tool: find_rulesets
      x-agent-skill: api-governance
      security:
      - ApiKey: []
      - {}
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/certify:
    post:
      tags:
      - Governance
      summary: Issue a governance certificate (PRO)
      description: Issue a tamper-evident certificate attesting an API description passed a named ruleset at a profile threshold. A SHA-256 fingerprint lets anyone re-verify it.
      x-tier: pro
      security:
      - ApiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - api
              properties:
                api:
                  description: The API description object.
                results:
                  type: array
                  items:
                    type: object
                  description: The Spectral findings the certificate attests.
                ruleset:
                  type: object
                  properties:
                    id:
                      type: string
                    version:
                      type: string
                profile:
                  type: string
                  description: One of the certification profiles (e.g. standard).
                issuer:
                  type: string
                validMonths:
                  type: integer
                  nullable: true
      responses:
        '200':
          description: Certificate.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '402':
          $ref: '#/components/responses/PaymentRequired'
      operationId: certify
      x-mcp-tool: certify_api
      x-agent-skill: api-governance
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/agent-export:
    post:
      tags:
      - Governance
      summary: Export agent-native governance artifacts (PRO)
      description: Turn a Spectral ruleset into an AGENTS.md governance block, a system-prompt instruction set, a per-rule remediation prompt pack, and a compact rule digest.
      x-tier: pro
      security:
      - ApiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - ruleset
              properties:
                ruleset:
                  type: object
                  description: A Spectral ruleset (with a rules object).
                format:
                  type: string
                name:
                  type: string
      responses:
        '200':
          description: Agent-native artifacts.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '402':
          $ref: '#/components/responses/PaymentRequired'
      operationId: agentExport
      x-mcp-tool: export_agent_rules
      x-agent-skill: api-governance
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/pipeline-audit:
    post:
      tags:
      - Governance
      summary: Audit a repo Spectral CI maturity (PRO)
      description: Score a repository Spectral governance pipeline against an 8-point maturity rubric and get a prioritized punch-list. Supply files inline, or a public repo (owner/name) to fetch.
      x-tier: pro
      security:
      - ApiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                repo:
                  type: string
                  description: GitHub repo as owner/name (public).
                ref:
                  type: string
                  description: Branch or SHA (default HEAD).
                files:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                      content:
                        type: string
      responses:
        '200':
          description: Maturity score and punchlist.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '402':
          $ref: '#/components/responses/PaymentRequired'
      operationId: pipelineAudit
      x-mcp-tool: audit_pipeline
      x-agent-skill: api-governance
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/toolsmith:
    post:
      tags:
      - Governance
      summary: Forge MCP tools and Agent Skills (PRO)
      description: From an OpenAPI, forge an MCP server design, per-operation tools, Agent Skills, an enriched OpenAPI (x-mcp / x-agent-skills), a server.json, and apis.json properties.
      x-tier: pro
      security:
      - ApiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - document
              properties:
                document:
                  type: string
                  description: The OpenAPI as YAML or JSON text.
      responses:
        '200':
          description: Forged MCP and skills artifacts.
          content:
            application/json:
              schema:
                type: object
          headers:
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Window:
              $ref: '#/components/headers/XRateLimitWindow'
            X-RateLimit-Tier:
              $ref: '#/components/headers/XRateLimitTier'
        '402':
          $ref: '#/components/responses/PaymentRequired'
      operationId: toolsmith
      x-mcp-tool: forge_mcp_tools
      x-agent-skill: api-agent-readiness
    servers:
    - url: https://api.apievangelist.com/v1
      description: Production
  /governance/context-gate:
    post:
      tags:
      - Governance
      summary: Emit a governed agent surface (PRO)
      description: Choose which operations and fields your API exposes to agents; emit a governed Tyk OpenAPI, an MCP tool manifest, and a Spectral ruleset with PII/secret checks. Defaults to the whole surface when no selection is supplied.
      

# --- truncated at 32 KB (53 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/api-evangelist/refs/heads/main/openapi/api-evangelist-governance-api-openapi.yml