MCP API Client (Beta)

A Model Context Protocol (MCP) server that call APIs using YAML config files.

This server allows you connect to APIs using simple a config YAML file! 🤩

Ideal for: #lazy-programmers #nocode #lowcode #ai-integrators #automation #api-gateway #data-pipelines #rapid-prototyping #llm-integration #makers

If you don't have advance APIs call skills using a programming language or you just want a fast way to connect your AI model with an API using MCP, you will LOVE 💖 this MCP.

Support

YOU CAN HELP ME GET IT SOON!

Your help would really motivate me to get it done by May 30th, 2025!

Make a reaction and give me a motivational comment on mcp.so repository

Help me on mcp.so

... and yes. A donation to help cover my coffee and rent would be amazing! 🙏🙏

ko-fi

Features

Configure multiple API endpoints using YAML
Automatic MCP tool creation from YAML config file.
Automatic MCP fetch API creation from YAML config file.
Supports all HTTP methods (GET, POST, PATCH, PUT, DELETE) [✨PARTIAL✨]
Set API Headers [✨COMMING SOON✨]
Set API path parameters (like /users/:id) [✨COMMING SOON✨]
Set API Token [✨COMMING SOON✨]
Environment variable interpolation for sensitive data [✨COMMING SOON✨]
Automatic parameter generation from URL templates [✨COMMING SOON✨]
...and best of all, SAVE COUNTLESS HOURS FOR HUMANITY 👏😎😉 by connecting your LLM to any API.

Use cases

Connect to N8N, Make.com or Zapier webhook: Make actions in other platforms connecting to automations or integration tools.
AI Model Integration: Quickly connect LLMs or other AI models to external APIs for data retrieval, enrichment, or action execution without custom code.
Rapid Prototyping: Build and test API workflows using YAML configuration, ideal for hackathons, demos, or proof-of-concept projects.
No-Code/Low-Code Automation: Enable non-developers to define and call APIs securely using simple YAML files and environment variables.
Data Pipelines: Orchestrate API calls as part of ETL or data processing pipelines, leveraging MCP tools for modularity and reuse.
API Gateway: Expose multiple backend APIs through a unified MCP interface, simplifying integration for downstream consumers.
Secure API Access: Manage secrets and tokens via environment variables, keeping sensitive data out of source code and YAML files.

Getting started

Get a copy of default api.yaml.

npx -y mcp-api-client --init

You can test default api.yaml with express test server test/server.js. Execute in other terminal.

npx -y mcp-api-client --test-server

Add MCP to your agent config file.

Example for Claude Client settings file:

"mcp": { "servers": { "mcp-api-client": { "command": "npx", "args": [ "-y", "mcp-api-client", "path-to-api.yaml" ] }, } }

Example for Visual Studio Code settings file:

"mcp": { "servers": { "mcp-api-client": { "command": "npx", "args": [ "-y", "mcp-api-client", "path-to-api.yaml" ] }, } }

Just Ask!

Ask to Claude LLM in MCP client

YAML Configuration File

Each API YAML file can include global metadata with MCP information:

metadata: General information about the API set name: The name of the API collection version: The version of the configuration description: A description of the API set

and a list of API endpoint definitions:

apis: A list of API endpoint definitions. Each endpoint should have - name: The unique name for this API endpoint description: A short description of what this endpoint does url: The endpoint URL (It does not supports path parameters like `{id} yet`) method: HTTP method (GET, POST, PATCH, PUT, DELETE) api-token: API token (supports environment variables) content: Request configuration headers: Request headers (key-value pairs) query: Query parameters (for GET or other methods, as a list of objects with name, type, default, required, description) body: Request body schema (for POST, PUT, PATCH, as a list of objects with name, type, default, required, description)

See public/apis.yaml for a complete example with metadata and all HTTP methods and parameter types.

Config Example

apis: - name: getUser url: https://api.example.com/users/{id} method: GET content: headers: Accept: application/json - name: createUser url: https://api.example.com/users method: POST api-token: ${API_TOKEN} content: headers: Content-Type: application/json body: name: string email: string ...

TODO

POST
PUT
PATCH
DELETE
headers
API_TOKEN

Bugs and Requests

https://github.com/molavec/mcp-api-client/issues

Contributing

Fork the repository
Create your feature branch
Commit your changes
Push to the branch
Create a new Pull Request

License

MIT

Deploy Server

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Related Resources

Need Help?

Report Issue

Tools

Related MCP Servers

OpenAI MCP Server
arthurcolle
-
security
F
license
-
quality
A Model Context Protocol server implementation that enables connection between OpenAI APIs and MCP clients for coding assistance with features like CLI interaction, web API integration, and tool-based architecture.
Last updated -
36
MCP Server Python Template
Cris-0k
-
security
-
license
-
quality
A streamlined foundation for building Model Context Protocol servers in Python, designed to make AI-assisted development of MCP tools easier and more efficient.
Last updated -
13
MIT License
MCP Gateway
Timandes
-
security
A
license
-
quality
A server that translates Model Context Protocol (MCP) tool callings to traditional HTTP API requests, allowing existing HTTP APIs to be integrated into MCP territory through configurable mappings.
Last updated -
1
Apache 2.0
MCP REST API Server
vinaykp
-
security
F
license
-
quality
A server implementation of the Model Context Protocol (MCP) that provides REST API endpoints for managing and interacting with MCP resources.
Last updated -

View all related MCP servers

MCP YAML API