This PR implements complete support for the TypeScript Universal Tool Calling Protocol (UTCP) while maintaining 100% backward compatibility with the existing Model Context Protocol (MCP) implementation.

Overview

The repository now supports both protocols:

• MCP (Model Context Protocol) - Original stdio/SSE transport for direct LLM application integration
• UTCP (Universal Tool Calling Protocol) - Modern HTTP-based protocol for scalable, web-friendly tool calling

Key Features Added

UTCP Server Implementation

• New --transport utcp option that starts an HTTP server
• Tool discovery endpoint: GET /utcp returns UTCP manual with available tools
• Tool execution endpoints: POST /tools/{tool_name} for calling specific tools
• Full CORS support for web client integration
• Same two tools (list_doc_sources and fetch_docs) available in UTCP format

Usage Examples

# Start UTCP server
mcpdoc --transport utcp --urls "LangGraph:https://langchain-ai.github.io/langgraph/llms.txt" --port 8080

# Test the endpoints
curl http://localhost:8080/utcp  # Discover tools
curl -X POST http://localhost:8080/tools/list_doc_sources -H "Content-Type: application/json" -d '{}'
curl -X POST http://localhost:8080/tools/fetch_docs -H "Content-Type: application/json" -d '{"url": "https://example.com/docs.txt"}'

UTCP Client Integration

The server works with standard UTCP clients:

// sample_providers.json
[
  {
    "name": "mcpdoc_server",
    "provider_type": "http", 
    "url": "http://localhost:8080/utcp",
    "http_method": "GET"
  }
]

import { UtcpClient } from '@utcp/sdk';

const client = await UtcpClient.create({
    providers_file_path: './sample_providers.json'
});

const tools = await client.toolRepository.getTools();
const result = await client.call_tool('list_doc_sources', {});

Implementation Details

Architecture

• UTCP Adapter Layer (src/utcp-adapter.ts) - Converts MCP tools to UTCP format
• Shared Logic - Core documentation fetching logic reused between protocols
• Protocol Selection - CLI transport option determines which protocol to use

Tool Compatibility

Both protocols expose identical functionality:

Backward Compatibility

• All existing MCP functionality preserved unchanged
• Same CLI arguments and configuration files work identically
• stdio and SSE transports continue to work as before
• No breaking changes to existing integrations

Testing & Quality

• 37 total tests (31 existing + 6 new UTCP tests) - all passing
• Full type safety with TypeScript strict mode
• Code quality checks pass (Prettier, ESLint, TypeScript compiler)
• Manual testing verified with curl commands

Documentation Updates

• Updated README with UTCP sections and comparison table
• Added examples/ directory with usage patterns for both protocols
• Created sample_providers.json for UTCP client configuration
• Enhanced CLI help text to show new transport option

This implementation provides a seamless migration path to UTCP while preserving all existing MCP functionality, making mcpdoc compatible with both traditional MCP applications and modern HTTP-based tool calling systems.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.