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/

🚀 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

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/