Skip to content
Agentmart
Submit a tool

Testrail MCP Server

Connect AI assistants to TestRail: manage test cases, suites, runs, results, and attachments.

Connector by uarlouski · GitHub account verified by the MCP Registry

IndexedApache-2.0Local (stdio)★ 44
Write a review

Chalk Labs

Need help deploying Testrail MCP Server?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/uarlouski-testrail-mcp-server

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Connect AI assistants to TestRail: manage test cases, suites, runs, results, and attachments.

Use cases: testing

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
19 read · 13 write · 1 delete
Secrets
1 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 33

Read from the source code; the running server may list different tools.

Read 19 · Look things up without changing anything.

  • get_case
  • get_case_fields
  • get_case_history
  • get_cases
  • get_configurations
  • get_labels
  • get_priorities
  • get_results
  • get_shared_step
  • get_shared_step_history
  • get_shared_steps
  • get_statuses
Show 7 more tools
  • get_templates
  • get_users
  • query_attachment
  • query_project
  • query_run
  • query_section
  • query_suite

Write 13 · Create, change, send or run things.

  • add_attachment
  • add_case
  • add_results
  • add_results_for_cases
  • add_shared_step
  • export_cases_for_rag
  • mutate_run
  • mutate_section
  • mutate_suite
  • resolve_case_field
  • update_case
  • update_cases
Show 1 more tools
  • update_shared_step

Delete 1 · Delete, drop, revoke or wipe things.

  • delete_entity

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • TESTRAIL_API_KEY

Other settings (environment variables or headers).

  • TESTRAIL_ALLOW_DELETE_OPERATIONS
  • TESTRAIL_ALLOW_READ_OPERATIONS
  • TESTRAIL_ALLOW_WRITE_OPERATIONS
  • TESTRAIL_DISABLED_TOOLS
  • TESTRAIL_ENABLE_CASE_HISTORY
  • TESTRAIL_ENABLE_DEPRECATED_TOOLS
  • TESTRAIL_ENABLE_RAG_TOOLS
  • TESTRAIL_ENABLE_SHARED_STEPS
  • TESTRAIL_INSTANCE_URL
  • TESTRAIL_REQUEST_TIMEOUT_MS
  • TESTRAIL_USERNAME

Network hosts it talks to 5

  • example.testrail.io · found in code
  • github.com · found in code
  • glama.ai · found in code
  • opengraph.githubassets.com · found in code
  • uarlouski.github.io · found in code

Files it touches

  • Your home directory (~)
  • Any path the agent passes to its tools

Tools (33)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • add_attachment

    Add an attachment to a test case, test run, or test result in TestRail. If the file_path points to a directory, it will be automatically zipped before uploading. Maximum upload size is 256MB.

  • add_case

    Create a new test case in TestRail. The create operation requires knowing valid field names that are returned by get_case_fields tool.

  • add_results

    Add one or more test results to a test run

  • add_results_for_cases

    Add one or more test results to a test run using case IDs instead of test IDs

  • add_shared_step

    Creates a new set of shared test steps.

  • delete_entity

    Deletes a specified TestRail entity (case, shared_step, or attachment) by its ID.

  • export_cases_for_rag

    Export test cases as formatted Markdown documents with companion JSON metadata sidecar files for Knowledge Base and RAG ingestion. Provide either 'case_ids' to export specific cases, or 'project_id' (with optional 'suite_id', 'filter', 'where') to query and export cases from TestRail. If exporting more than 25 cases, batch them into chunks of ~25 and execute in parallel with a shared output_dir to prevent tool call timeouts.

  • get_case

    Get detailed information about a test case including its custom fields

  • get_case_fields

    Get the field schema for test cases for a specific project. You should normally provide project_id to get fields applicable to your project. If you truly need all fields across all projects, you may omit project_id, but this is rarely what you want. Returns available fields with their types and options (for dropdown fields).

  • get_case_history

    Returns the revision and change history of a test case. Useful for tracking case updates, checking changes since a specific revision or timestamp, or getting the last N revisions.

  • get_cases

    Get all test cases for a project. Filter by section, API params (priority, type), or any field including custom fields via 'where'. Returns case IDs, titles, and any additional requested fields.

  • get_configurations

    Get all configuration groups and configurations for a project in TestRail.

  • get_labels

    Get all available test case labels (sometimes called tags) for a project. Returns label IDs and names that can be used when creating or updating test cases.

  • get_priorities

    Get all available test case priorities (e.g. Critical, High, Medium, Low). Returns priority IDs and names that can be used when creating or updating test cases.

  • get_results

    Get results for a specific test in TestRail.

Show 18 more tools
  • get_shared_step

    Returns the details of a specific shared test step.

  • get_shared_step_history

    Returns the change history of a set of shared test steps.

  • get_shared_steps

    Returns a list of shared test steps for a specified project.

  • get_statuses

    Get all available test statuses (e.g. Passed, Failed, Blocked). Returns status IDs and names that can be used with add_result and get_tests

  • get_templates

    Get available test case templates for a project. Template IDs determine which fields are available when creating or updating test cases

  • get_users

    Get active users from TestRail. Resolves active users globally or per-project. If global fetch is forbidden (for non-admin accounts), falls back to merging users across all active projects so users referenced as reviewers or assignees can be resolved.

  • mutate_run

    Create a new test run or update an existing one in TestRail. Set payload.action to 'create' or 'update' to specify the operation.

  • mutate_section

    Create a new section or update an existing section in TestRail. Set payload.action to 'create' or 'update' to specify the operation.

  • mutate_suite

    Create a new test suite or update an existing one in TestRail. Set payload.action to 'create' or 'update' to specify the operation.

  • query_attachment

    Download a single attachment or list all attachments for a test case or test run in TestRail. Set payload.action to 'one' or 'many' to specify the operation.

  • query_project

    Retrieve a single project or all projects in TestRail. Set payload.action to 'one' or 'many' to specify the operation.

  • query_run

    Retrieve a single test run or all test runs for a project in TestRail. Set payload.action to 'one' or 'many' to specify the operation.

  • query_section

    Retrieve a single section or all sections for a project in TestRail. Set payload.action to 'one' or 'many' to specify the operation.

  • query_suite

    Retrieve a single test suite or all test suites for a project in TestRail. Set payload.action to 'one' or 'many' to specify the operation.

  • resolve_case_field

    Resolve numeric reference IDs of a Multi-select case field (type ID 12) into their textual values for a specific project.

  • update_case

    Update a test case in TestRail. The update operation requires knowing valid field names that are returned by get_case_fields tool. Supports partial updates — only specify the fields you want to change.

  • update_cases

    Bulk update multiple test cases with the same field values. The update operation requires knowing valid field names that are returned by get_case_fields tool. More efficient than calling update_case multiple times.

  • update_shared_step

    Updates an existing set of shared test steps. Updates are propagated automatically to all test cases using these steps.

Compare and alternatives

    Featured in

    Signals

    Stars
    44
    Forks
    5
    Open issues
    2
    Last commit
    Oct 23, 2026 (8 days ago)
    Last release
    Oct 26, 2026 (5 days ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    io.github.uarlouski/testrail-mcp-server
    Version
    3.3.1
    Auth
    API key
    Packages
    npm @uarlouski/testrail-mcp-server
    License
    Apache-2.0
    Repository
    github.com/uarlouski/testrail-mcp-server
    First seen
    Oct 24, 2026
    Last checked
    Oct 26, 2026
    Source
    Official MCP Registrygithub-graphql

    Done for you

    Rather not set it up yourself?

    Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

    See how we build AI agents →Read the case studies

    Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

    launches shipped
    50+
    launches shipped
    media placements
    500+
    media placements
    founders on every account
    2
    founders on every account

    Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

    Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

    Get Testrail MCP Server running in your business

    Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

    Goes to the Chalk Labs founders, not the newsletter. Privacy

    Need help deploying Testrail MCP Server?

    CallGet help
    Cite this page

    Testrail MCP Server. Agent Mart. https://agentmart.dev/connectors/uarlouski-testrail-mcp-server (last updated 2026-10-26)