universal-tool-calling-protocol

utcp-specification: Define a Universal Standard for Calling Tools

UTCP specifies a common way for AI systems and other clients to discover and call tools across protocols such as HTTP, WebSocket, CLI, and MCP. It is aimed at tool providers and client developers who want protocol-independent integrations.

ActiveTypeScriptAIMCPDocumentation
View on GitHub Compare
Stars
314
Forks
28
Stars, last 30 days
+24
Last commit
25 days ago
Contributors
5

Our take

Activeregular commits and releases

Health score

39/100

How it is scored
Activity
54
Community
35
Issues
21
Pull requests
46

+24 stars in the last 30 days

UTCP is an actively maintained, protocol-focused specification with recent commits and a release in the past year, but teams should assess its implementation and operational fit separately from the documentation.

Good fit if

  • You are building tool providers or callers and want a documented protocol-independent approach to discovery and invocation.
  • Your integration needs include one or more of the documented HTTP, CLI, WebSocket, Text, or MCP protocols.
  • You are willing to align with the repository's stated Apache-2.0 and MPL-2.0 licensing split for the relevant content.

Look elsewhere if

  • You need a ready-to-run tool-calling runtime rather than a specification and documentation repository.
  • Your required protocol or integration model is not covered by the documented options.
  • You cannot accommodate the Node.js 18+ requirement to build and preview the documentation site locally.
All health signals
Last commit2026-09-16 (25 days ago)
Commits, last 90 days64
Releases, last 12 months1 (latest showcase-hexis, 2026-08-08)
Contributors5 (top contributor: 74% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days2
Project age16 months

Checked on 2026-10-12 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

337

Forks

31

Change since Nov 18, 2026: +1 stars·0 forks

Overview

The Universal Tool Calling Protocol specification describes how clients can discover and call tools from different providers without tying integrations to a single transport. It addresses the fragmentation that arises when tools expose different protocols and call formats.

The repository is the specification and its documentation, not the tool-calling runtime itself. It is useful to teams building tool providers or callers who want to implement a shared interface, and to people evaluating UTCP before adopting its reference implementation.

Key Features

  • Defines tool discovery mechanisms and call formats, including templates.
  • Describes a plugin architecture for extending protocol support.
  • Documents HTTP, CLI, WebSocket, Text, and MCP protocol options.
  • Covers authentication approaches including API keys, OAuth, and custom authentication.
  • Specifies error handling, response processing, and validation guidance.
  • Provides guidance for tool providers and tool callers, plus API reference documentation.
  • Includes a migration guide for moving from UTCP v0.1 to v1.0.

Use Cases

  • An AI-agent platform team can use the specification when it needs to connect tools exposed over different protocols through a common discovery and calling model.
  • A tool provider can consult the provider guide when documenting a tool for clients that should not depend on one transport.
  • A client developer can use the caller and protocol guides when implementing discovery and calls across HTTP, CLI, WebSocket, or MCP.
  • A team upgrading an existing UTCP integration can use the v0.1-to-v1.0 migration guide to assess changes before updating its implementation.

What you need

Detected in the repository

  • Node.js >=18.0 (from package.json)
  • Automated checks on GitHub Actions

Getting Started

To preview the documentation locally:

npm install
npm start

See the README for setup details, protocol guides, and links to reference implementations. The UTCP website also provides project information.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Alternatives

  • modelcontextprotocol: MCP standardizes a specific client-server protocol, while UTCP defines a protocol-independent layer for discovering and calling tools across multiple transports.
ProjectLanguageLicenseStarsStatus
utcp-specificationTypeScript–314Active
modelcontextprotocolTypeScript–9.6kActive

Considerations

  • This repository defines a standard; adopting it still requires a compatible client or provider implementation. The README points to a separate Python reference implementation.
  • The project is active, with regular recent commits and a release within the past year. The measured data reports five contributors, while issue closures and merged pull requests were both absent over the last 90 days, so do not assume rapid issue or change-request turnaround.
  • The measured requirements list Node.js 18 or newer for the documentation site. The README separately describes installing Python UTCP packages for use of the core implementation and protocol plugins.
  • The README describes a directory-based license split: Apache-2.0 for most repository content and MPL-2.0 for API reference documentation. Check the applicable subtree license before reusing API docs.
  • The repository metadata reports its license as NOASSERTION, so verify the license files and notices directly for your intended use.

Found this useful?

Share it with someone who would like utcp-specification.

Comparisons