# Give coding agents a real handle on Huly.

Huly MCP is a TypeScript Model Context Protocol server for reading and changing Huly workspace state from the agent tools you already use.

## Quick Start: Agent-guided setup

Hand this to your coding agent and let it configure Huly MCP in your local MCP client.

## Principles

### Full Huly parity.

Expose the full useful Huly surface through MCP: projects, issues, documents, people, calendars, activity, files, processes, tests, and the rest.

### LLM-friendly access.

Raw APIs are not enough. Tools need clear names, forgiving identifiers, rich results, useful errors, and enough context for an agent to take the next step.

### Middleware for agents.

Huly MCP exists between Huly and coding agents: it translates Huly's workspace model into a tool surface agents can reason about and act through.

## Tool Surface

Huly MCP exposes Huly workspace data and actions as MCP tools for agents that need to plan, inspect, update, and verify work without losing context.

- projects
- issues
- documents
- comments
- milestones
- contacts
- channels
- cards
- custom fields
- attachments
- storage
- calendar
- time tracking
- activity
- notifications
- search
- associations
- workspace
- spaces
- labels
- tags
- tag categories
- leads
- processes
- sdk discovery
- task management
- test management
- user statuses