UTCP-MCP Bridge

The last MCP server you'll ever need.

A universal, all-in-one MCP server that brings the full power of the Universal Tool Calling Protocol (UTCP) to the MCP ecosystem.

Quick Start

Add this configuration to your MCP client (Claude Desktop, etc.):

{
  "mcpServers": {
    "utcp": {
      "command": "npx",
      "args": ["@utcp/mcp-bridge"],
      "env": {
        "UTCP_CONFIG_FILE": "/path/to/your/.utcp_config.json"
      }
    }
  }
}

That's it! No installation required. The bridge will automatically:

• Download and run the latest version via npx
• Load your UTCP configuration from the specified path
• Register all your UTCP manuals as MCP tools
• Provide a unified interface to manage your tool ecosystem

Configuration

Create a .utcp_config.json file to configure your tools and services:

{
    "load_variables_from": [
      {
        "variable_loader_type": "dotenv",
        "env_file_path": ".env"
      }
    ],
    "manual_call_templates": [
      {
          "name": "openlibrary",
          "call_template_type": "http",
          "http_method": "GET", 
          "url": "https://openlibrary.org/static/openapi.json",
          "content_type": "application/json"
      }
    ],
    "post_processing": [
      {
          "tool_post_processor_type": "filter_dict",
          "only_include_keys": ["name", "description"],
          "only_include_tools": ["openlibrary.*"]
      }
    ],
    "tool_repository": {
      "tool_repository_type": "in_memory"
    },
    "tool_search_strategy": {
      "tool_search_strategy_type": "tag_and_description_word_match"
    }
}

Available MCP Tools

The bridge exposes these MCP tools for managing your UTCP ecosystem:

• register_manual - Register new UTCP manuals/APIs
• deregister_manual - Remove registered manuals
• call_tool - Execute any registered UTCP tool
• search_tools - Find tools by description
• list_tools - List all registered tool names
• get_required_keys_for_tool - Get required environment variables
• tool_info - Get complete tool information and schema

What is UTCP?

The Universal Tool Calling Protocol (UTCP) allows you to:

• Connect to any API via HTTP, OpenAPI specs, or custom formats
• Use command-line tools with automatic argument parsing
• Process text and files with built-in utilities
• Chain and combine multiple tools seamlessly

With this MCP bridge, all your UTCP tools become available in Claude Desktop and other MCP clients.

Features

• Zero installation - Works via npx
• Universal compatibility - Works with any MCP client
• Dynamic configuration - Update tools without restarting
• Environment isolation - Each project can have its own config
• Comprehensive tool management - Register, search, call, and inspect tools
• Web interface available - See web_ui_utcp_mcp_bridge/

Python Version

For Python users, see the standalone Python implementation in python_mcp_bridge/

Web Interface

For advanced management with a web UI, check out web_ui_utcp_mcp_bridge/