Skip to main content

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools and data sources. Ekso’s MCP server exposes 35 tools that AI agents can use to read and write project data — create items, plan sprints, query finance reports, and more. MCP is supported by Claude, Cursor, VS Code, Windsurf, and other AI-powered tools.

Server Endpoint

The MCP server is available at:
https://{tenant}.ekso.app/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):
{
  "mcpServers": {
    "ekso": {
      "url": "https://{tenant}.ekso.app/mcp/"
    }
  }
}

Claude Code

Add via the CLI:
claude mcp add ekso --transport http https://{tenant}.ekso.app/mcp/

Cursor

Add this to your Cursor MCP settings (.cursor/mcp.json):
{
  "mcpServers": {
    "ekso": {
      "url": "https://{tenant}.ekso.app/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 as the REST API.

Tool Categories

Ekso’s MCP tools are organized by domain:
DomainToolsDescription
Items4Create, update, plan, and unplan work items
Boards5Query boards, cycles, items within cycles, and budget reason codes
Cycles2Create and update cycles (sprints/iterations)
Containers4List containers, their processes, items, and filter items
Fields7Get status, priority, severity, resolution, and custom field values
Users1List users with profile details
Processes2List processes and their workflow definitions
Finance8Profitability, time tracking, billing, and finance metadata
Config2Hooks and labels

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.