mcp-swagger
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| listEndpointsA | Liste tous les endpoints disponibles dans l'API avec leurs méthodes HTTP et tags. Retourne un résumé léger optimisé pour économiser les tokens. |
| getEndpointDetailsB | Récupère les détails complets d'un endpoint spécifique : paramètres, body, réponses, schémas, etc. |
| searchEndpointsA | Recherche des endpoints par mot-clé dans les chemins, descriptions, tags. Retourne les résultats triés par pertinence. |
| getSchemasA | Récupère les schémas de données (DTOs) définis dans l'API. Sans paramètre, liste tous les schémas disponibles. Avec un nom, retourne le schéma complet. |
| listTagsA | Liste tous les tags utilisés pour catégoriser les endpoints dans l'API. |
| getEndpointsByTagA | Récupère tous les endpoints associés à un tag spécifique. Plus ciblé que listEndpoints avec filtre. |
| getApiInfoA | Récupère les métadonnées de l'API : titre, version, description, serveurs, contact, licence. |
| getSecuritySchemesA | Liste les schémas d'authentification/autorisation disponibles (OAuth2, API keys, Bearer tokens, etc.). |
| getServerUrlsA | Récupère les URLs des serveurs disponibles et leurs environnements (dev, staging, prod, etc.). |
| validateEndpointPathA | Vérifie si un chemin d'endpoint existe. Si non, suggère des chemins similaires pour corriger les erreurs de frappe. |
| getSchemaReferencesA | Trouve tous les endpoints qui utilisent un schéma spécifique. Utile pour l'analyse d'impact lors de modifications de schémas. |
| generateCurlExampleA | Génère un exemple de commande curl pour un endpoint spécifique, incluant les headers et un corps de requête exemple. |
| getDeprecatedEndpointsA | Liste tous les endpoints marqués comme dépréciés. Utile pour la planification de migrations. |
| executeEndpointA | Exécute un endpoint API et retourne la réponse réelle. Utilise automatiquement les headers requis définis dans le Swagger. Parfait pour tester les endpoints et récupérer des données en temps réel. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Each tool has a clearly distinct purpose: fetching server URLs, executing endpoints, listing endpoints, getting details, searching, schema handling, tag management, API info, security schemes, validation, schema references, curl generation, and deprecated endpoints. The descriptions are explicit enough to prevent confusion even where similar (e.g., listEndpoints vs getEndpointsByTag).
All tool names follow a consistent verb+noun camelCase pattern (get, execute, list, search, validate, generate). The style is uniform and predictable, making it easy to infer tool behavior from names.
14 tools is well within the ideal 3-15 range and each tool addresses a specific need in exploring and interacting with a Swagger-defined API. The count feels comprehensive without being bloated.
The toolset covers the full lifecycle of API interaction: discovery (list, search, details), execution, schema exploration, security information, validation, and deprecation tracking. There are no obvious dead ends or missing essential operations for a Swagger/OpenAPI use case.