# `ExUtcp`
[🔗](https://github.com/universal-tool-calling-protocol/elixir-utcp/blob/main/lib/ex_utcp.ex#L1)

Elixir implementation of the Universal Tool Calling Protocol (UTCP).

UTCP is a modern, flexible, and scalable standard for defining and interacting
with tools across a wide variety of communication protocols. It is designed to
be easy to use, interoperable, and extensible, making it a powerful choice for
building and consuming tool-based services.

## Features

* Built-in transports for HTTP, CLI, Server-Sent Events, streaming HTTP,
  GraphQL, MCP, WebSocket, gRPC, TCP, UDP, and WebRTC
* Variable substitution via environment variables or `.env` files
* In-memory repository for storing providers and tools discovered at runtime
* Utilities such as `OpenApiConverter` to convert OpenAPI definitions into UTCP manuals
* Example programs demonstrating the client usage

## Getting Started

```elixir
alias ExUtcp.{Client, Config}

# Create a client configuration
config = Config.new(providers_file_path: "providers.json")

# Create a UTCP client
{:ok, client} = Client.start_link(config)

# Search for tools
{:ok, tools} = Client.search_tools(client, "", 10)

# Call a tool
{:ok, result} = Client.call_tool(client, "provider.tool_name", %{"arg" => "value"})
```

## Architecture

The library is organized into several main components:

* `ExUtcp.Client` - Main client interface
* `ExUtcp.Config` - Configuration management
* `ExUtcp.Providers` - Provider implementations for different protocols
* `ExUtcp.Transports` - Transport layer implementations
* `ExUtcp.Tools` - Tool definitions and management
* `ExUtcp.Repository` - Tool and provider storage

# `version`

Returns the version of the ExUtcp library.

---

*Consult [api-reference.md](api-reference.md) for complete listing*