# ITM Platform — how to use (mcp.ai)

Connect your ITM Platform account and use 10 tools for project management straight from your AI agent. Connect with your own API key. ITM Platform provides modern project, portfolio, task, service, financial, risk, and resource management APIs plus read-only DataMart analytics.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_itm_platform?ms=1787291100000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `itm_platform_aggregate_datamart_components`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/itm_platform`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/itm_platform/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/itm_platform/aggregate/datamart/components` — Run a bounded read-only DataMart aggregation over project and service records for portfolio analytics.
  - body: { pipeline: object[] }
- `POST https://api.mcp.ai/api/itm_platform/create/project` — Create an ITM Platform project with its schedule and optional account-specific classification IDs. This changes customer data and has no v2 delete counterpart.
  - body: { name: string, type_id?: integer, end_date?: string, status_id?: integer, start_date?: string, description?: string, priority_id?: integer, internal_code?: string, is_kanban_project?: boolean, performing_unit_id?: integer, internal_cost_center?: string }
- `POST https://api.mcp.ai/api/itm_platform/create/task` — Create a task in an ITM Platform project using account-defined type, priority, and status names.
  - body: { name: string, details?: string, end_date?: string, sprint_id?: string, type_name?: string, project_id: integer, start_date?: string, status_name?: string, priority_name?: string, swimlane_name?: string, parent_task_id?: string, display_in_portfolio?: boolean }
- `POST https://api.mcp.ai/api/itm_platform/get/project` — Return the full current details of one project by its ITM Platform project ID.
  - body: { project_id: integer }
- `POST https://api.mcp.ai/api/itm_platform/list/reference/data` — List account-defined project or task statuses, priorities, or types needed to form valid project and task mutations.
  - body: { kind: string }
- `POST https://api.mcp.ai/api/itm_platform/search/datamart/components` — Search the read-only DataMart for project or service analytics records and return one offset-paginated page.
  - body: { sort?: object, limit?: integer, where?: object, project?: object, next_cursor?: string }
- `POST https://api.mcp.ai/api/itm_platform/search/projects` — Search projects by account-specific filters and return one page of project summaries with a continuation cursor.
  - body: { fields?: string[], filter?: object, page_size?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/itm_platform/search/tasks` — Search tasks across accessible projects and return one page of task summaries with a continuation cursor.
  - body: { fields?: string[], filter?: object, page_size?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/itm_platform/update/project` — Update selected fields of an existing ITM Platform project and return the provider result. Verify important changes with Get Project.
  - body: { name?: string, type_id?: integer, end_date?: string, status_id?: integer, project_id: integer, start_date?: string, description?: string, priority_id?: integer, internal_code?: string, performing_unit_id?: integer, internal_cost_center?: string }
- `POST https://api.mcp.ai/api/itm_platform/update/task` — Update selected descriptive, scheduling, hierarchy, or custom fields on an existing ITM Platform project task. Verify important changes with Search Tasks.
  - body: { name?: string, details?: string, task_id: integer, end_date?: string, sprint_id?: string, project_id: integer, start_date?: string, custom_fields?: object[], swimlane_name?: string, parent_task_id?: string, display_in_portfolio?: boolean }

## Example prompts
- "What can I do in ITM Platform?"
- "Show me a summary of my ITM Platform account"

## More
- Page: https://mcp.ai/itm_platform
- Agent spec (llms.txt): https://mcp.ai/itm_platform/llms.txt
- Postman collection: https://mcp.ai/itm_platform/postman.json