io.github.sani-savaliya/agentify

Official

by sani-savaliya · TypeScript

Turn any OpenAPI/Swagger spec into an MCP server - every API operation becomes an agent tool.

Agentify: OpenAPI-to-MCP Server Generator

This MCP server, io.github.sani-savaliya/agentify, turns an OpenAPI/Swagger specification into an MCP server. For each API operation in the provided spec, it creates a corresponding MCP tool, enabling structured access to the underlying API via the Model Context Protocol.

🛠️ Key Features

Input: OpenAPI/Swagger spec
Output: MCP server
Mapping: every API operation becomes an agent tool

🚀 Use Cases

Generate an MCP server from an existing OpenAPI/Swagger document
Expose API operations as MCP tools for downstream agents

⚡ Developer Benefits

Reuse existing OpenAPI/Swagger definitions
Tool-per-operation structure derived from the spec’s operations

⚠️ Limitations

Based on the availability and coverage of operations in the provided OpenAPI/Swagger specification

Install

Configuration

Environment variables

AGENTIFY_BEARER_TOKENsecret

Optional. Sent to the upstream API as 'Authorization: Bearer <token>'.

AGENTIFY_API_KEYsecret

Optional API key for the upstream API. Sent as a header (name auto-discovered from the spec's security schemes, default X-API-Key).

AGENTIFY_API_KEY_HEADER

Optional. Override the header name used for AGENTIFY_API_KEY.

AGENTIFY_API_KEY_QUERY

Optional. Send AGENTIFY_API_KEY as this query parameter instead of a header.

AGENTIFY_BASIC_USER

Optional HTTP basic auth username (pair with AGENTIFY_BASIC_PASS).

AGENTIFY_BASIC_PASSsecret

Optional HTTP basic auth password (pair with AGENTIFY_BASIC_USER).

Arguments

openapi_spec_urlrequired

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agentify": {
      "command": "npx",
      "args": [
        "-y",
        "agentify-openapi@0.1.1",
        "<YOUR_VALUE>"
      ],
      "env": {
        "AGENTIFY_BEARER_TOKEN": "<YOUR_AGENTIFY_BEARER_TOKEN>",
        "AGENTIFY_API_KEY": "<YOUR_AGENTIFY_API_KEY>",
        "AGENTIFY_API_KEY_HEADER": "<YOUR_AGENTIFY_API_KEY_HEADER>",
        "AGENTIFY_API_KEY_QUERY": "<YOUR_AGENTIFY_API_KEY_QUERY>",
        "AGENTIFY_BASIC_USER": "<YOUR_AGENTIFY_BASIC_USER>",
        "AGENTIFY_BASIC_PASS": "<YOUR_AGENTIFY_BASIC_PASS>"
      }
    }
  }
}