API Suggestion Server

What is API Suggestion Server?

API Suggestion Server is an MCP (Model Context Protocol) server that suggests suitable API endpoints based on OpenAPI specifications. It helps AI models and developers find the best endpoints for a given purpose by analyzing available APIs.

How to use API Suggestion Server?

Install by cloning the repository and running npm install. Configure OpenAPI specifications (local files or URLs) in server.config.ts. Start the server with npm start. The server communicates via stdio over MCP and exposes a suggest_api tool that accepts a purpose string and returns matching endpoints.

Key features of API Suggestion Server

• Collects API endpoints from multiple OpenAPI specs.
• Suggests relevant endpoints based on user’s purpose.
• Integrates with AI models via the MCP protocol.
• Supports YAML and JSON formats.
• Accepts both local file paths and URLs for specs.

Use cases of API Suggestion Server

• Developers querying available APIs for a specific operation.
• AI assistants recommending API calls during conversation.
• Automated API discovery in microservice environments.
• Quick endpoint lookup for integration tasks.

FAQ from API Suggestion Server

What are the prerequisites for API Suggestion Server?

Node.js 18+ and npm or yarn.

What OpenAPI formats does API Suggestion Server support?

YAML (.yaml, .yml) and JSON (.json), both from local files and public URLs.

How does API Suggestion Server communicate?

The server uses standard input/output (stdio) through the MCP protocol.

Can I add my own API specifications to API Suggestion Server?

Yes, add OpenAPI files to the schemas directory or specify URLs in server.config.ts.

What license does API Suggestion Server use?

MIT.