# Swagger/OpenAPI

> Use this tool when you need to interact with REST APIs through their OpenAPI specifications, enabling AI assistants to fetch documentation, explore endpoints, and execute authenticated API requests. It solves problems related to API exploration, testing workflows, and integrating external services into AI-assisted development tasks. With inputs including OpenAPI specifications and authentication credentials, and outputs such as detailed endpoint information and validated responses, this tool provides a comprehensive interface for API testing and integration.

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

## Description

MCP server for Swagger/OpenAPI documentation and API testing that enables AI assistants to interact with REST APIs through their OpenAPI specifications. Built by Amr Salem, it provides tools to fetch API documentation, list and explore endpoints with filtering capabilities, get detailed endpoint information including parameters and schemas, execute authenticated API requests, and validate responses against OpenAPI schemas. Supports multiple authentication methods including API keys, Bearer tokens, and basic authentication with automatic token refresh, making it valuable for API exploration, testing workflows, and integrating external services into AI-assisted development tasks.

## Trust

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

## Facts

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

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/swagger-openapi)
- **Repository:** <https://github.com/amrsa1/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": "swagger-openapi"
    }
  }
}
```

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