OpenAPI Directory MCP Server

A Model Context Protocol (MCP) server that provides access to the APIs.guru directory - the world's largest repository of OpenAPI specifications with over 3,000 API Specs from 600+ providers. Now with custom OpenAPI spec import - seamlessly integrate your own APIs alongside the public directory.

Table of Contents

• Acknowledgments
• Features
• Context Optimization & Progressive Discovery
• Quick Start
• Custom OpenAPI Specifications
• Available Tools
• Available Resources
• Available Prompts
• Configuration
• Example Usage
• Architecture
• Performance
• Development
• Contributing
• License
• Support This Project
• Support
• Credits

Acknowledgments

This project builds upon the exceptional work of APIs.guru and their comprehensive OpenAPI Directory. The APIs.guru project maintains the largest repository of machine-readable API definitions, providing an invaluable resource to the developer community through their free API service at https://api.apis.guru/v2.

Their dedication to creating and maintaining this comprehensive directory of OpenAPI specifications makes projects like this possible. We are deeply grateful for their contribution to the open source ecosystem and their commitment to making API discovery accessible to everyone.

The source data is provided under the Creative Commons Zero v1.0 Universal License, reflecting their generous approach to knowledge sharing.

Features

| Feature | Description | |-------------------------------|--------------------------------------------------------------| | Zero Configuration | Works out of the box with sensible defaults | | Comprehensive API Coverage| Access to 3,000+ API specs from APIs.guru | | Custom OpenAPI Import | Import and manage your own APIs with zero-touch integration | | Context-Aware Security | Smart security scanning with legitimate pattern recognition | | Context Optimized | Progressive discovery reduces context usage by ~95% | | Smart Search Results | Relevance ranking + newest versions first + provider priority | | Intelligent Caching | 24-hour TTL persistent caching with management tools | | Rich Tool Set | 22 specialized tools for API discovery and endpoint analysis | | Slash Commands | All prompts auto-exposed as Claude Code slash commands | | Paginated Resources | Efficient data access with pagination support | | NPX Ready | Install and run with a single command | | **Type Saf

... View full README on GitHub