# OpenAPI Schema

> Use this tool when you need to explore and understand API structures through Large Language Models, solving problems of manual OpenAPI documentation parsing and complexity comprehension. It takes OpenAPI schema files (JSON or YAML) as input and provides outputs like endpoint listings, schema searches, and example retrievals in YAML format. Ideal for AI assistant conversations requiring API exploration and integration, it streamlines workflows by converting complex OpenAPI structures into easily comprehensible information.

Canonical page: https://skillsregistry.net/skills/hannesj-openapi-schema  
JSON: https://api.skillsregistry.net/v1/skills/hannesj-openapi-schema

## Description

The OpenAPI Schema MCP server exposes OpenAPI specification information to Large Language Models through a set of specialized tools. Developed by Hannes Junnila, it loads any OpenAPI schema file (JSON or YAML) and provides tools for exploring API paths, operations, parameters, schemas, and security definitions. The server converts complex OpenAPI structures into YAML format for better LLM comprehension and includes features like endpoint listing, schema searching, and example retrieval. It's particularly valuable for workflows requiring API exploration and understanding within AI assistant conversations, eliminating the need to manually parse OpenAPI documentation.

## Trust

- **Trust score (0–1):** 0.96
- **Verification tier:** verified
- **Last scanned:** 2026-09-28

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** ai-ml
- **Updated:** 2026-09-28

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/hannesj-openapi-schema)
- **Repository:** <https://github.com/hannesj/mcp-openapi-schema>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "hannesj-openapi-schema"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/hannesj-openapi-schema` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/hannesj-openapi-schema/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt