# OpenAPI

> Use this tool when you need to integrate with REST APIs that provide OpenAPI documentation, as it automatically generates callable tools from OpenAPI specifications, handling HTTP requests and parameter mapping. It solves the problem of manual tool creation for API integration, supporting dynamic and environment-based configuration. It takes OpenAPI/Swagger documents as input and outputs callable tools for streamlined API communication.

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

## Description

This MCP server provides dynamic OpenAPI integration by automatically generating tools from OpenAPI specifications, built by Brian and Kun Liu using TypeScript with the Model Context Protocol SDK and openapi-mcp-generator. It parses OpenAPI/Swagger documents to create callable tools that handle HTTP requests with proper parameter mapping for path, query, and header parameters, plus request body handling, using the Got HTTP client for reliable API communication. The implementation runs as an Express server with streamable HTTP transport, supporting environment-based configuration for base URLs and API paths, making it valuable for integrating with any REST API that provides OpenAPI documentation without manual tool creation.

## Trust

- **Trust score (0–1):** 0.65
- **Verification tier:** scanned
- **Last scanned:** 2026-09-02

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** maps-location
- **Updated:** 2026-09-02

## Source

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

## 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": "onewalker-openapi"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/onewalker-openapi` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/onewalker-openapi/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