Skip to main content
Glama
muhammadyusuf-kurbonov

utel-mcp

utel-mcp

An MCP server that wraps the UTEL IP-telephony REST API as MCP tools and documentation resources.
Lets LLM agents discover and call UTEL API endpoints with proper auth baked in.

Built with FastMCP (Python).

Prerequisites

  • Python 3.11+

  • uv — package manager

Related MCP server: OpenAPI MCP Server

Setup

uv sync

Configuration

The server is configured through environment variables (no .env file is loaded automatically):

Variable

Required

Description

UTEL_API_BASE_URL

Yes

Base URL of the UTEL API instance (e.g. https://api.cc999.utel.uz/api/v1)

HTTP_BEARER_TOKEN

No

Sets an Authorization: Bearer <token> header on every request

MCP_DEBUG

No

Set to "true" to log full request payloads to /tmp/mcp_debug.log

Usage

uv run utel-mcp

This starts the MCP server on stdio transport — it communicates over standard input/output.
Configure your MCP host (Claude Desktop, OpenCode, etc.) to launch it as a stdio subprocess.

Tools

send_request

Sends an authenticated HTTP request to the UTEL API. The path is joined with UTEL_API_BASE_URL.

Parameters:

Parameter

Type

Default

Description

path

string

API path, e.g. /ats/ps-user. Leading slash recommended.

method

string

"GET"

HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)

headers

object

null

Extra headers (merged on top of defaults)

json_data

object

null

JSON body

params

object

null

Query parameters

Returns: Status code + response body as a string.

Pre-configured headers on every request: Accept: application/json, Content-Type: application/json, and Authorization: Bearer <token> (if HTTP_BEARER_TOKEN is set).

Resources (Built-in API Documentation)

The server exposes the full UTEL API reference as MCP resources, so agents can look up endpoint details without leaving the conversation:

Resource

Description

utel://api

Index of all available documentation topics

utel://api/{topic}

Documentation for a specific topic

utel://api/reference

Full comprehensive API reference (all topics)

utel://skill

Same as reference — alias for agent skill context

Available topics: intro, auth, call-history, statistics, trunks, voice-messages, sip-users, ivr, groups, queues, time-rules, voicemail, smart-redirect, webhooks, extension-ranges.

Source Layout

src/utel_mcp/
├── __init__.py    ← MCP server instance, tool/resource registration, entry point
├── config.py      ← Environment variable loading
├── utils.py       ← Shared helpers (header construction)
├── handlers.py    ← Tool and resource implementations
└── docs.py        ← Inline API documentation data

License

MIT

Install Server
F
license - not found
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/muhammadyusuf-kurbonov/utel-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server