# meta-api-mcp-server

Turns outside HTTP APIs into callable tools for an AI assistant, driven by a JSON file or a Postman collection. Handy when the agent needs live data from another service.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: savhascelik
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/savhascelik/meta-api-mcp-server
- Updated: 2025-09-09
- HTML: https://affpapa.org/en/nevibecode/mcp/meta-api-mcp-server

## What it does

This MCP server maps API endpoints onto tools the assistant can call on its own. You describe an API in JSON: base URL, auth method, endpoint list with parameters. GET, POST, PUT, DELETE and PATCH all work, and auth covers API keys and bearer tokens. One process serves several APIs at once, with configs read from a local file, a folder, a remote link or a list of configs.

A Postman collection saves you the hand-writing. Export it as v2.1.0 and point the server at the file, provided its name includes `postman`. It walks the endpoints, works out the auth scheme, pulls path and query parameters, inspects the request body and builds the tools. Your key then goes into `.env`, and the server tells you which variable name it expects. Visual editing of configs is done in MCP API Editor.

Global install runs through `npm install -g meta-api-mcp-server`, so Node.js and npm need to be present. In `mcp.json` you set the launch command plus the key variables; calls to the target API will fail without a working key, since the remote service rejects them.

## Requirements
- Needs: Node.js (commands run via npx)
- A remote (HTTP) option exists: the address is in the README
- Environment variables: `YOUR_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add meta-api-mcp-server -e YOUR_API_KEY=<YOUR_API_KEY> -- npx -y meta-api-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add meta-api-mcp-server --env YOUR_API_KEY=<YOUR_API_KEY> -- npx -y meta-api-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "meta-api-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "meta-api-mcp-server"
            ],
            "env": {
                "YOUR_API_KEY": "<YOUR_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "meta-api-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "meta-api-mcp-server"
            ],
            "env": {
                "YOUR_API_KEY": "<YOUR_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e YOUR_API_KEY=<YOUR_API_KEY> meta-api-mcp-server npx -y meta-api-mcp-server
```
Replace <…> with your own values

## When to use it
- expose your own API endpoints as tools for an AI assistant
- wire up an existing Postman collection without writing code
- serve several external APIs from one MCP process
- set API key or bearer token auth in the config
- pull an API config from a remote URL instead of a local file

## Example prompts
- Fetch page 2 of users from my API
- Build MCP tools from `My-API.postman_collection.json`
- Load the config at `api-configs/flexweather-endpoints.json` and call the weather forecast

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
