API & MCP
Everything a person can do on Trackwell Jira CSV Import, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://trackwelljiracsvimport.usefulweb.app/api/v1/calculate– run Trackwell Jira CSV ImportGET https://trackwelljiracsvimport.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Trackwell Jira CSV Import
Reads the CSV file Jira exports for a filter (all fields) and maps it to a Trackwell project file: issue types, statuses with their category, priorities, assignees and reporters, labels, components, fix versions, sprints, story points, estimates, time spent, parents, links, comments and custom fields. It reports exactly what was mapped and what was left out.
| Field | Type | Default | Description |
|---|---|---|---|
csv | textarea | — | Jira CSV export. In Jira: Filters → search → Export → Export Excel CSV (all fields). Paste it here or upload the file. |
csvFile | file | — | CSV file (optional). Used instead of the pasted text when given. |
key | text | — | Project key (optional). Empty = taken from the issue keys. |
name | text | — | Project name (optional) |
mode | select (auto, scrum, kanban) | "auto" | Board |
Every result contains
inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.
MCP (Model Context Protocol)
- Streamable HTTP endpoint:
https://trackwelljiracsvimport.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
trackwell_jira_csv_import - Local stdio connector:
node src/mcp-stdio.ts --tool=trackwell-jira-csv-import
{
"mcpServers": {
"trackwell-jira-csv-import": { "type": "http", "url": "https://trackwelljiracsvimport.usefulweb.app/mcp" }
}
}