legacy2mcp — Claude Code MCP server: what it does, how to install
Turns SOAP endpoints and REST APIs into typed MCP tools with audit logging. Mutations stay disabled by default, keeping queries safe.
claude mcp add legacy2mcp -- uvx legacy2mcpWhat legacy2mcp does
The tool scans legacy architectures live without requiring handwritten wrapper logic. For SOAP services, it inspects WSDL definitions via zeep, while HTTP APIs get parsed using Swagger discovery. It can also generate contracts from HAR network captures or Postman collections.
Safety is enforced before requests reach your backend. Inbound parameters are validated against strict JSON Schema definitions. Write operations remain disabled until configured otherwise in the generated YAML file. Every query goes straight into an audit log.
What it helps with
- expose legacy SOAP and WSDL methods to AI coding agents
- build typed MCP schemas from live REST and OpenAPI endpoints
- restrict database access to read-only queries with schema checks
- record audit logs for external backend calls
Example prompts for the agent
- Set up an MCP server from the SOAP endpoint at http://www.dneonline.com/calculator.asmx?WSDL
- Generate MCP tool definitions for the REST API at https://petstore3.swagger.io/api/v3
- Extract MCP tools from my Postman collection using legacy2mcp discover
How to install legacy2mcp
Platform CLI
claude mcp add legacy2mcp -- uvx legacy2mcpuvx runs the command named after the package; if the README names another one, use uvx --from legacy2mcp <command>
Platform CLI
codex mcp add legacy2mcp -- uvx legacy2mcpuvx runs the command named after the package; if the README names another one, use uvx --from legacy2mcp <command>
Config file
{
"mcpServers": {
"legacy2mcp": {
"command": "uvx",
"args": [
"legacy2mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from legacy2mcp <command>
Config file
{
"servers": {
"legacy2mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"legacy2mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from legacy2mcp <command>
Platform CLI
gemini mcp add legacy2mcp uvx legacy2mcpuvx runs the command named after the package; if the README names another one, use uvx --from legacy2mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about legacy2mcp
How to install legacy2mcp in Claude Code?
Run claude mcp add legacy2mcp -- uvx legacy2mcp in your terminal. This downloads and runs the server using uvx without manual environment setup.
What does legacy2mcp do?
It reads schemas from SOAP services or REST interfaces and exposes them as typed MCP tools. Every tool call undergoes schema validation before execution.
Does legacy2mcp allow write operations on backends?
Write operations stay excluded by default. The server operates in read-only mode and logs all incoming tool executions.
