> ## Documentation Index
> Fetch the complete documentation index at: https://ekso.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Tools

> Connect AI agents to Ekso via Model Context Protocol (MCP) — manage items, boards, cycles, and more.

## What is MCP?

[Model Context Protocol](https://modelcontextprotocol.io) (MCP) is an open standard that lets AI assistants interact with external tools and data sources. Ekso's MCP server exposes **104 tools** that AI agents can use to read and write project data — create items, plan sprints, manage documents, query finance reports, wire up webhook-style rule integrations, and more.

MCP is supported by Claude, Cursor, VS Code, Windsurf, and other AI-powered tools.

## Server endpoint

The MCP server is available at:

```text theme={null}
https://ekso.acme.com/mcp/
```

Ekso uses **Streamable HTTP** transport (stateless mode). Each MCP request goes through the standard authentication and authorization pipeline.

## Connecting

### Claude Desktop

Add this to your Claude Desktop configuration (`claude_desktop_config.json`):

```json theme={null}
{
  "mcpServers": {
    "ekso": {
      "url": "https://ekso.acme.com/mcp/"
    }
  }
}
```

### Claude Code

Add via the CLI:

```bash theme={null}
claude mcp add ekso --transport http https://ekso.acme.com/mcp/
```

### Cursor

Add this to your Cursor MCP settings (`.cursor/mcp.json`):

```json theme={null}
{
  "mcpServers": {
    "ekso": {
      "url": "https://ekso.acme.com/mcp/"
    }
  }
}
```

## Authentication

MCP requests use the same **Bearer token** authentication as the REST API. The token is included automatically when you authenticate through your AI tool's OAuth flow.

For tools that support it, the MCP server will initiate OAuth 2.0 authorization using the same [OAuth endpoints](/api-reference/introduction#oauth-20) as the REST API.

## Tool categories

Ekso's MCP tools are organized by domain:

| Domain                                      | Tools | Description                                                                                                |
| ------------------------------------------- | ----- | ---------------------------------------------------------------------------------------------------------- |
| [Item](/mcp-tools/item)                     | 13    | CRUD, copy, search, plan/unplan, dependency management, screen discovery, and resource queries             |
| [Board](/mcp-tools/board)                   | 6     | Query boards, cycles, items within cycles, budget reason codes, and CRUD                                   |
| [Cycle](/mcp-tools/cycle)                   | 4     | Create, update, delete cycles and view stats                                                               |
| [Container](/mcp-tools/container)           | 3     | List containers, their processes, and filter items with pagination                                         |
| [Area](/mcp-tools/area)                     | 3     | Create, update, and delete areas within containers                                                         |
| [Field](/mcp-tools/field)                   | 4     | Field catalog with type-specific metadata, list values, picker entity data, and filterable field discovery |
| [User](/mcp-tools/user)                     | 2     | List users and get current user profile                                                                    |
| [Process](/mcp-tools/process)               | 2     | List processes and their workflow definitions                                                              |
| [Label](/mcp-tools/label)                   | 4     | Query, create, update, and delete labels                                                                   |
| [Annotation](/mcp-tools/annotation)         | 4     | Read and manage comments and annotations on entities                                                       |
| [Link](/mcp-tools/link)                     | 3     | Create and manage links between items                                                                      |
| [Watch](/mcp-tools/watch)                   | 6     | Manage pins and subscriptions on entities                                                                  |
| [Time](/mcp-tools/time)                     | 5     | Non-billable time entry CRUD and resource time logs                                                        |
| [Finance](/mcp-tools/finance)               | 12    | Profitability, time tracking, billing, and finance metadata                                                |
| [Doc](/mcp-tools/doc)                       | 12    | Document folders, documents, and content management                                                        |
| [Ticketing](/mcp-tools/ticketing)           | 4     | Email conversation threads, ticket replies, and search by email or mailbox                                 |
| [Access Control](/mcp-tools/access-control) | 1     | View access control rules                                                                                  |
| [User Group](/mcp-tools/user-group)         | 4     | Manage user groups for access control                                                                      |
| [Clock](/mcp-tools/clock)                   | 1     | View business clock and SLA schedule configurations                                                        |
| [Rule](/mcp-tools/rule)                     | 2     | View automation rules and attach endpoint actions                                                          |
| [Constraint](/mcp-tools/constraint)         | 5     | Field-level validation constraints on items                                                                |
| [Notification](/mcp-tools/notification)     | 3     | Scheduled notification configurations                                                                      |
| [Config](/mcp-tools/config)                 | 1     | Post-event hooks                                                                                           |

## Resources

In addition to tools, Ekso's MCP server exposes **10 read-only resources** that provide AI-optimized domain knowledge — covering concepts, terminology, and workflows. Resources help agents build context before invoking tools. See the [Resources](/mcp-tools/resources) page for the full list.

## Prompts

Ekso's MCP server provides **7 conversation prompts** — pre-built templates that guide AI agents through multi-step planning workflows like sprint planning, review, and standup. Prompts pre-load live data (boards, cycles, items) so the AI can act immediately. See the [Prompts](/mcp-tools/prompts) page for details.

## Deep links

Item, container, and board tool responses include a `url` field that links directly to the entity in the Ekso web app. AI agents can present these as clickable links so users can jump straight from an AI response into the application.

## Read vs. write tools

Each tool is marked as either **read-only** or **read-write**:

* **Read-only** tools query data without side effects. AI agents can call these freely for context gathering.
* **Read-write** tools create or modify data. These require appropriate permissions and most AI agents will confirm before executing them.

## Rate limits

MCP tools are rate-limited separately from the REST API using the `Mcp` rate limiting policy.