MCP YAML API

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! 🙏🙏

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that creates tools from API configurations defined in YAML files, allowing easy integration of external APIs into an MCP ecosystem without coding.

Related MCP Servers

MCP Server
la-rebelion
-
security
A
license
-
quality
MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
Last updated -
4
3
TypeScript
MIT License
MCP Server
agentico-dev
-
security
A
license
-
quality
MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
Last updated -
13
2
TypeScript
MIT License
MCP-OpenAPI
rmasters
-
security
A
license
-
quality
An MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.
Last updated -
2
Python
MIT License
API-Market MCP Server
Noveum
-
security
A
license
-
quality
A Model Context Protocol server that exposes over 200+ APIs from API.market as MCP resources, allowing large language models to discover and interact with various APIs through natural language commands.
Last updated -
111
2
TypeScript
MIT License

View all related MCP servers