API Evangelist MCP

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Overview of API Evangelist",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "topic"
  ],
  "properties": {
    "topic": {
      "type": "string",
      "description": "The topic to build a guide for."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Topic guide",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find services",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Service slug, as find_services returns it, e.g. \"governance-agent-readiness\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "include": {
      "type": "array",
      "items": {
        "enum": [
          "content"
        ]
      },
      "description": "Pass [\"content\"] to inline the full body (Pro). Omitted, you get the summary."
    }
  }
}

{
  "title": "Get service",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find solutions",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Solution (vendor) slug, as find_solutions returns it, e.g. \"adobe\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Get solution",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find tools",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Tool slug, as find_tools returns it, e.g. \"ajv\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Get tool",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Contact Kin Lane",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Content types to include — plural resource names: posts, services, solutions, tools, areas, papers, videos, conversations, guidance, rules, policies, standards, strategies…, e.g. [\"posts\",\"papers\"]."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Search API Evangelist",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "year": {
      "type": "string",
      "description": "Four-digit year; only posts whose date starts with it, e.g. \"2024\"."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find posts",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Post slug — date-prefixed, as find_posts returns it, e.g. \"2026-09-29-you-cannot-see-your-own-api-from-the-outside\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "include": {
      "type": "array",
      "items": {
        "enum": [
          "content"
        ]
      },
      "description": "Pass [\"content\"] to inline the full body (Pro). Omitted, you get the summary."
    }
  }
}

{
  "title": "Get post",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find areas",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Area slug, as find_areas returns it, e.g. \"agents\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Get area",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "type": {
      "enum": [
        "guidance",
        "rules",
        "policies",
        "standards",
        "strategies",
        "schema",
        "properties",
        "experiences",
        "lifecycle"
      ],
      "type": "string",
      "description": "Building-block type: guidance, rules, policies, standards, strategies, schema, properties, experiences or lifecycle."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find building blocks",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "type",
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Building-block slug within `type`, as find_building_blocks returns it, e.g. \"access\" with type \"guidance\"."
    },
    "type": {
      "enum": [
        "guidance",
        "rules",
        "policies",
        "standards",
        "strategies",
        "schema",
        "properties",
        "experiences",
        "lifecycle"
      ],
      "type": "string",
      "description": "Building-block type: guidance, rules, policies, standards, strategies, schema, properties, experiences or lifecycle."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "include": {
      "type": "array",
      "items": {
        "enum": [
          "content"
        ]
      },
      "description": "Pass [\"content\"] to inline the full body (Pro). Omitted, you get the summary."
    }
  }
}

{
  "title": "Get building block",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find conversations",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Conversation slug — date-prefixed, as find_conversations returns it, e.g. \"2026-09-01-lukasz-gornicki\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "include": {
      "type": "array",
      "items": {
        "enum": [
          "content"
        ]
      },
      "description": "Pass [\"content\"] to inline the full body (Pro). Omitted, you get the summary."
    }
  }
}

{
  "title": "Get conversation",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find papers",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Paper slug, as find_papers returns it, e.g. \"change-on-the-agent-surface\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Get paper",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find videos",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Video slug, as find_videos returns it, e.g. \"adam-duvander\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "include": {
      "type": "array",
      "items": {
        "enum": [
          "content"
        ]
      },
      "description": "Pass [\"content\"] to inline the full body (Pro). Omitted, you get the summary."
    }
  }
}

{
  "title": "Get video",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "timeline"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "timeline": {
      "enum": [
        "api",
        "resources",
        "industries",
        "people"
      ],
      "type": "string",
      "description": "Which timeline: api, resources, industries or people."
    }
  }
}

{
  "title": "Get timeline",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "section"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "section": {
      "enum": [
        "history",
        "technology",
        "business",
        "politics",
        "governance",
        "evangelism"
      ],
      "type": "string",
      "description": "Guidance section: history, technology, business, politics, governance or evangelism."
    }
  }
}

{
  "title": "Get guidance section",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text over title, summary, tags, and body."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "default",
        "title",
        "date"
      ],
      "type": "string",
      "description": "Order when there is no `q`: \"default\" (dated content newest first, the rest A-Z), \"title\" (A-Z) or \"date\" (newest first). A `q` always orders by relevance."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag slugs; match any by default."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "default": "any",
      "description": "How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return only these keys on each record, e.g. [\"slug\",\"title\",\"url\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "category": {
      "enum": [
        "resources",
        "actions",
        "personas",
        "domains",
        "schemas",
        "tags"
      ],
      "type": "string",
      "description": "Vocabulary category: resources, actions, personas, domains, schemas or tags."
    }
  }
}

{
  "title": "Find vocabulary",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Feeds",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text matched against tag labels, e.g. \"governance\"."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "sort": {
      "enum": [
        "count",
        "breadth"
      ],
      "type": "string",
      "description": "\"count\" (default, most-used first) or \"breadth\" (spread across the most content types)."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find tags",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "slug": {
      "type": "string",
      "description": "Tag slug, as find_tags returns it, e.g. \"apis\"."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only return tagged items of these types, e.g. [\"posts\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Get tag",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "type",
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Slug of the item to find related content for, within `type`, e.g. \"2026-09-29-you-cannot-see-your-own-api-from-the-outside\"."
    },
    "type": {
      "type": "string",
      "description": "Content type of the item `slug` names — the plural path name: posts, services, solutions, tools, areas, papers, videos, conversations, guidance…, e.g. \"posts\"."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only return related items of these types, e.g. [\"papers\",\"posts\"]."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find related",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Catalog stats",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text matched against company name, e.g. \"chase\"."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find company insights",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Insights dimensions",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "type": {
      "enum": [
        "service",
        "tool",
        "standard"
      ],
      "type": "string",
      "default": "service",
      "description": "What to rank by adoption across the companies: \"service\" (default), \"tool\" or \"standard\"."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Insights adoption",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Company slug, as find_company_insights returns it, e.g. \"jp-morgan-chase\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Get company insight",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Company slug, as find_company_insights returns it, e.g. \"jp-morgan-chase\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Company gaps",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Company slug, as find_company_insights returns it, e.g. \"jp-morgan-chase\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Company dimensions",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Company slug, as find_company_insights returns it, e.g. \"jp-morgan-chase\"."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "How many peers to return, 1-100."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Company peers",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Company slug, as find_company_insights returns it, e.g. \"jp-morgan-chase\"."
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "How many whitespace rows to return, 1-200."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Company whitespace",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Company slug, as find_company_insights returns it, e.g. \"jp-morgan-chase\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Company signals",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Substring match on the entity name."
    },
    "kind": {
      "enum": [
        "service",
        "tool",
        "standard"
      ],
      "type": "string",
      "description": "Entity kind: \"service\", \"tool\" or \"standard\"."
    },
    "page": {
      "type": "integer",
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "min_companies": {
      "type": "integer",
      "description": "Only entities carried by at least this many companies."
    }
  }
}

{
  "title": "Find entities",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "kind",
    "slug"
  ],
  "properties": {
    "kind": {
      "enum": [
        "service",
        "tool",
        "standard"
      ],
      "type": "string",
      "description": "Entity kind: \"service\", \"tool\" or \"standard\"."
    },
    "slug": {
      "type": "string",
      "description": "Entity slug or display name — either resolves (\"spark\" and \"Apache Spark\" both work)."
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "How many named companies to return, 1-500."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "industry": {
      "type": "string",
      "description": "Restrict the named companies to one industry."
    }
  }
}

{
  "title": "Entity demand",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Find measured standards",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Standards body slug, as find_measured_standards returns it, e.g. \"asyncapi\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Standard adoption",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Standards body slug, as find_measured_standards returns it, e.g. \"asyncapi\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Standard coalition",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page number, 1-based (default 1). Use with `limit` to walk a long list."
    },
    "slug": {
      "type": "string",
      "description": "Standards body slug, as find_measured_standards returns it, e.g. \"asyncapi\"."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 25)."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  }
}

{
  "title": "Standard repositories",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Lint an API description",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Governance coverage",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "waivers",
    "violations"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "waivers": {
      "type": [
        "string",
        "object"
      ],
      "description": "The waivers file to reconcile — sanctioned violations, with expiry."
    },
    "violations": {
      "type": [
        "array",
        "object",
        "string"
      ],
      "description": "Lint output to reconcile against the waivers. An array of findings, or the object a linter returned."
    }
  },
  "additionalProperties": true
}

{
  "title": "Reconcile waivers",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "results": {
      "type": [
        "array",
        "object"
      ],
      "description": "Spectral findings to render. An array, or the `{ results: [...] }` object a run returned."
    }
  },
  "additionalProperties": true
}

{
  "title": "Governance HTML report",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "certificate",
    "api"
  ],
  "properties": {
    "api": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description being attested or verified. String or parsed object."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "certificate": {
      "type": [
        "string",
        "object"
      ],
      "description": "The governance certificate to re-verify. Alias: `cert`."
    }
  },
  "additionalProperties": true
}

{
  "title": "Verify a governance certificate",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Classify sensitive API fields",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "old",
    "new"
  ],
  "properties": {
    "new": {
      "type": [
        "string",
        "object"
      ],
      "description": "The CANDIDATE version to compare against the baseline. Aliases: `to`, `revision`."
    },
    "old": {
      "type": [
        "string",
        "object"
      ],
      "description": "The BASELINE version of the document. Aliases: `from`, `base`."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Diff two API versions",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "API scorecard",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "apis"
  ],
  "properties": {
    "apis": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "The estate: one entry per API, [{ id, document }]. `document` alone is accepted for a single API."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Govern an API estate",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Deprecation posture",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "descriptor"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "descriptor": {
      "type": [
        "string",
        "object"
      ],
      "description": "An API Onboarding Descriptor (AID) to validate. Aliases: `aid`, `document`."
    }
  },
  "additionalProperties": true
}

{
  "title": "Validate an onboarding descriptor",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "api"
  ],
  "properties": {
    "api": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description being attested or verified. String or parsed object."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Certify an API",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "ruleset"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "ruleset": {
      "type": "object",
      "description": "A Spectral ruleset to run instead of the catalog default. Score against rules you never adopted means little — pass your own."
    }
  },
  "additionalProperties": true
}

{
  "title": "Export rules for agents",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Audit a governance pipeline",
  "readOnlyHint": true,
  "openWorldHint": true
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Forge MCP tools from OpenAPI",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Gate agent context",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document",
    "overlay"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "overlay": {
      "type": [
        "string",
        "object"
      ],
      "description": "An OpenAPI Overlay document whose actions are applied to `document`."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Apply an OpenAPI Overlay",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Mock payloads",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Code snippets",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Score reusability",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Map the API experience",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Generate llms.txt + AGENTS.md",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "ruleset"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "ruleset": {
      "type": "object",
      "description": "A Spectral ruleset to run instead of the catalog default. Score against rules you never adopted means little — pass your own."
    }
  },
  "additionalProperties": true
}

{
  "title": "Validate a ruleset",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Query a JSONPath",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "ruleset",
    "cases"
  ],
  "properties": {
    "cases": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Fixtures: [{ name, document, expect }] where `expect` is a list of rule codes that must fire, a { code: count } map, or [] for a clean lint. Optional `forbid`: codes that must not fire."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "ruleset": {
      "type": "object",
      "description": "A Spectral ruleset to run instead of the catalog default. Score against rules you never adopted means little — pass your own."
    }
  },
  "additionalProperties": true
}

{
  "title": "Test a ruleset against fixtures",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document",
    "rule"
  ],
  "properties": {
    "rule": {
      "type": "string",
      "description": "A rule id, e.g. \"info-require-license\" or \"operation-operationId\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Explain a rule result",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "rule"
  ],
  "properties": {
    "rule": {
      "type": "string",
      "description": "A rule id, e.g. \"info-require-license\" or \"operation-operationId\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Describe a rule",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Detect a document format",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Lint an agent skill",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Document a ruleset",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Baseline violations",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "federation"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "federation": {
      "type": [
        "string",
        "object"
      ],
      "description": "The federation model: { central: { rules: [{ code, severity }] }, domains: [{ id, adoptions: [{ code, state, severity?, reason? }] }] }. YAML/JSON string or object."
    }
  },
  "additionalProperties": true
}

{
  "title": "Federate rulesets",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Fingerprint the OpenAPI generator",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "document"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "document": {
      "type": [
        "string",
        "object"
      ],
      "description": "The API description to operate on — OpenAPI, AsyncAPI, Arazzo or JSON Schema. A YAML/JSON string or an already-parsed object; both are accepted."
    }
  },
  "additionalProperties": true
}

{
  "title": "Fix lint findings",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "guide"
  ],
  "properties": {
    "guide": {
      "type": "string",
      "description": "The API style guide as prose or Markdown (up to 40 KB)."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Ruleset from a style guide",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    }
  },
  "additionalProperties": true
}

{
  "title": "Get the org ruleset",
  "readOnlyHint": true,
  "openWorldHint": false
}

{
  "type": "object",
  "required": [
    "ruleset"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "ruleset": {
      "type": "object",
      "description": "A Spectral ruleset to run instead of the catalog default. Score against rules you never adopted means little — pass your own."
    }
  },
  "additionalProperties": true
}

{
  "title": "Set the org ruleset",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "problem"
  ],
  "properties": {
    "tool": {
      "type": "string",
      "description": "Optional name of the tool that produced it."
    },
    "about": {
      "type": "string",
      "description": "Optional slug, area, paper or story the report concerns."
    },
    "context": {
      "type": "string",
      "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."
    },
    "problem": {
      "type": "string",
      "description": "What was wrong. Be specific — the tool you called, the arguments, and what came back."
    },
    "expected": {
      "type": "string",
      "description": "What you expected instead."
    },
    "severity": {
      "enum": [
        "wrong",
        "misleading",
        "unhelpful"
      ],
      "type": "string",
      "description": "wrong = factually incorrect; misleading = correct but reads as something else; unhelpful = right and useless."
    }
  }
}

{
  "title": "Send feedback (free)",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

openlint://profiles

ae://overview

ae://services

ae://contact

ae://stats

ae://area/{slug}

ae://tag/{slug}

ae://post/{slug}

ae://guide/{topic}

openlint://rules/{format}