@trulit/mcp-server

The official MCP server for Trulit. Gives any MCP client (Cursor, Claude Desktop, Claude Code, Codex, Windsurf, OpenCode) read/write access to your Trulit workspace: projects, test suites, test cases, runs, defects, automation, and AI test generation.

Why

Most test-management MCP servers only expose CRUD. Trulit adds the things QA teams actually want from an agent:

• AI test generation from a requirement
• Coverage gap analysis
• Run automation and live status
• Defects with two-way JIRA sync
• Pass/fail summaries and analytics

Install

No install needed if you use npx. The snippets below pull the latest version on demand.

Get a token

1. Open app.trulit.com and go to Settings → Developer → MCP & API Tokens.
2. Click Generate token, copy the tlt_pat_… value (shown once).

Configure your client

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "trulit": {
      "command": "npx",
      "args": ["-y", "@trulit/mcp-server"],
      "env": { "TRULIT_API_TOKEN": "tlt_pat_..." }
    }
  }
}

Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "trulit": {
      "command": "npx",
      "args": ["-y", "@trulit/mcp-server"],
      "env": { "TRULIT_API_TOKEN": "tlt_pat_..." }
    }
  }
}

Claude Code

claude mcp add trulit \
  --env TRULIT_API_TOKEN=tlt_pat_... \
  -- npx -y @trulit/mcp-server

Codex / Windsurf / OpenCode

Same JSON shape as Cursor; check your client's docs for the config file location.

Environment variables

| Variable | Default | Purpose | | --- | --- | --- | | TRULIT_API_TOKEN | (required) | Personal Access Token | | TRULIT_MCP_URL | https://mcp.trulit.com | Remote MCP endpoint (point at https://mcp.uat.trulit.com for UAT) |

CLI flags --token and --url override the env vars.

How it works

trulit-mcp is a transparent stdio to Streamable HTTP bridge. Every JSON-RPC frame from your client is forwarded to the Trulit MCP server with your PAT, and every response (including server-initiated notifications such as tools/list_changed) is forwarded back. The tool catalog is never duplicated, so new tools shipped on the server are immediately available without updating this package.

Troubleshooting

• "Missing TRULIT_API_TOKEN": set the env var or pass --token.
• "failed to connect" / 401: token is wrong, revoked, or expired. Generate a new one.
• 406 Not Acceptable: your client is hitting a non-Trulit URL via TRULIT_MCP_URL. The bridge always sends the required Accept: application/json, text/event-stream header.
• Tools not appearing in Cursor: fully quit and relaunch Cursor; MCP servers are loaded once at startup.

License

MIT