# Swagger/OpenAPI

> Use this tool when you need to integrate AI agents with REST APIs or dynamically generate callable tools from API specifications. It solves problems of API documentation, authentication, and invocation by parsing Swagger/OpenAPI specifications and exposing available operations as callable tools. It takes API endpoints and specifications as input and outputs dynamically generated tools that can invoke HTTP requests with various authentication methods.

Canonical page: https://skillsregistry.net/skills/mary-code217-swagger-openapi  
JSON: https://api.skillsregistry.net/v1/skills/mary-code217-swagger-openapi

## Description

Bridges AI agents with REST APIs by parsing Swagger/OpenAPI specifications and dynamically generating callable tools. Fetches API documentation from configurable endpoints, analyzes available operations, and exposes them as tools that can invoke HTTP requests. Supports multiple API configurations simultaneously, handles various authentication methods including Bearer tokens, Basic Auth, and API keys, and provides hierarchical API browsing with keyword search capabilities. Includes Docker support for deployment.

## Trust

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

## Facts

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

## Source

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

## 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": "mary-code217-swagger-openapi"
    }
  }
}
```

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