utcp-specification  by universal-tool-calling-protocol

Standard for AI tool interaction across diverse protocols

Created 5 months ago
262 stars

Top 97.4% on SourcePulse

GitHubView on GitHub
Project Summary

The Universal Tool Calling Protocol (UTCP) specification standardizes how AI systems and clients discover and invoke tools across diverse protocols like HTTP, WebSocket, and CLI. It offers a flexible, scalable, and modern approach, abstracting protocol complexities for developers.

How It Works

UTCP defines tool discovery, call formats, and response validation. Version 1.0 emphasizes a modular plugin architecture supporting multiple protocols (HTTP, CLI, WebSocket, Text, MCP) and enhanced Pydantic data models for robust validation. It includes advanced authentication, improved error handling, performance optimizations, and full asynchronous client support, promoting modularity and extensibility.

Quick Start & Requirements

Install the core package with pip install utcp; protocol plugins (e.g., utcp-http) are separate. Local documentation preview requires Node.js >= 18.0 and npm/yarn. Clone the repo (git clone https://github.com/universal-tool-calling-protocol/utcp-specification.git), run npm install, then npm start to serve docs locally at http://localhost:3000.

Highlighted Details

  • v1.0 features a plugin architecture for modularity.
  • Supports multiple protocols: HTTP, CLI, WebSocket, Text, MCP.
  • Enhanced data models with validation and advanced authentication.
  • Optimized clients with full async/await support.
  • Follows semantic versioning.

Maintenance & Community

Contributions are welcomed via pull requests. The repository includes guidelines for documentation modification and version control.

Licensing & Compatibility

Distributed under the Mozilla Public License 2.0 (MPL-2.0), which permits broad use but requires modifications to licensed code to be shared under the same license.

Limitations & Caveats

The README does not list explicit limitations or bugs. Users migrating from v0.1 should consult the migration guide for details on breaking changes.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
2
Issues (30d)
1
Star History
25 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.