tyran-mcp
v0.1.3
Published
A Model Context Protocol (MCP) server that provides access to the Tyran AI for agent management and execution.
Readme
Tyran MCP Server
A Model Context Protocol (MCP) server that provides access to the Tyran AI for agent management and execution.
Installation
npm install -g tyran-mcpOR
npx tyran-mcpUsage
Set your environment variables:
export TYRAN_API_KEY=your_api_key
# Optional: override base URL (defaults to https://tyran.ai)
# export TYRAN_BASE_URL=https://your-hostRun the server:
tyran-mcpOr use with npx:
TYRAN_API_KEY=your_key npx tyran-mcpConfiguration
The server requires one environment variable:
TYRAN_API_KEY- Your Tyran API key (Bearer)TYRAN_BASE_URL- Optional. Defaults tohttps://tyran.ai.
Available Tools
The server provides the following MCP tools:
Tools
list_agents- GET /api/mcp/agentscreate_agent- POST /api/mcp/agentsupdate_agent_prompt- PATCH /api/mcp/agents/:agentIdrun_agent- POST /api/mcp/agents/:agentId/run (returns bundleId + resourceUri)get_bundle- GET /api/mcp/bundles/:bundleId (helper)get_job- GET /api/mcp/jobs/:jobId (helper)
Resources
- URI:
mcp://terra/bundles/{bundleId} - mimeType:
application/json - The server emits
resources/updatedwhen the run completes (or fails/timeout).
Development
Clone the repository:
git clone <repository-url>
cd tyran-mcpInstall dependencies:
pnpm installBuild the project:
pnpm run buildRun in development mode:
pnpm run devLicense
MIT
