Skip to main content
Glama

mcp-x

One command to turn any CLI tool or REST API into an MCP server for Claude.

pip install mcp-x

mcp-x run git           # Claude can now use git
mcp-x run psql          # Claude can now query your database
mcp-x run https://api.stripe.com/openapi.json  # Claude can use the Stripe API

How it works

  1. Parses --help output (CLI tools) or OpenAPI spec (REST APIs) to discover capabilities

  2. Optionally enhances tool schemas using Claude for better descriptions (set ANTHROPIC_API_KEY)

  3. Starts an MCP server on a free local port

  4. Auto-registers it in ~/.claude.json — Claude sees the new tools immediately, no config needed

Related MCP server: mcp-api-gateway

Install

pip install mcp-x

Usage

# CLI tools — any tool with --help output
mcp-x run git
mcp-x run ffmpeg
mcp-x run kubectl
mcp-x run aws

# REST APIs — OpenAPI spec URL or local file
mcp-x run openapi.json
mcp-x run https://api.example.com/openapi.json

# Options
mcp-x run git --no-llm       # skip Claude schema enhancement
mcp-x run git --eject        # print generated schemas as JSON, don't run
mcp-x run git --port 9000    # use a specific port

# Manage registered servers
mcp-x list                   # show all registered mcp-x servers
mcp-x remove git             # unregister a server

How auto-registration works

mcp-x run git starts an SSE MCP server and immediately writes to ~/.claude.json:

{
  "mcpServers": {
    "mcp-x-git": {
      "url": "http://localhost:8742",
      "type": "sse"
    }
  }
}

Claude Code picks this up automatically. When you Ctrl+C, mcp-x removes the entry cleanly.

Schema enhancement

If ANTHROPIC_API_KEY is set, mcp-x sends raw help-text schemas to claude-haiku for cleanup — better descriptions, proper parameter names, cleaner tool definitions.

export ANTHROPIC_API_KEY=sk-ant-...
mcp-x run git   # schemas enhanced automatically

Use --no-llm to skip this and use raw parsed schemas.

Requirements

  • Python 3.10+

  • Claude Code (for auto-registration to work)

License

MIT

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/LakshmiSravyaVedantham/mcp-x'

If you have feedback or need assistance with the MCP directory API, please join our Discord server