> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testdino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TestDino MCP Server

> Connect AI assistants to TestDino for querying test results and debugging failures via local CLI or remote URL.

export const VideoSchema = ({name, description, thumbnailUrl, uploadDate, duration, contentUrl, embedUrl}) => {
  const schema = {
    "@context": "https://schema.org",
    "@type": "VideoObject",
    name,
    description,
    thumbnailUrl,
    uploadDate,
    ...duration ? {
      duration
    } : {},
    ...contentUrl ? {
      contentUrl
    } : {},
    ...embedUrl ? {
      embedUrl
    } : {},
    publisher: {
      "@type": "Organization",
      name: "TestDino",
      logo: {
        "@type": "ImageObject",
        url: "https://docs.testdino.com/logo/light.svg"
      }
    }
  };
  return <script type="application/ld+json" dangerouslySetInnerHTML={{
    __html: JSON.stringify(schema)
  }} />;
};

<VideoSchema name="TestDino MCP Example" description="Example session using the TestDino MCP server with an AI assistant to debug Playwright test failures." thumbnailUrl="https://i.ytimg.com/vi/Qg4e0kEHVK0/maxresdefault.jpg" uploadDate="2025-12-16T00:00:00+00:00" contentUrl="https://www.youtube.com/watch?v=Qg4e0kEHVK0" embedUrl="https://www.youtube.com/embed/Qg4e0kEHVK0" />

<Callout icon="book-open" color="#3B82F6">
  **What you'll learn**

  * What the TestDino MCP server does and which tools it exposes
  * When to pick the Local vs Remote install path
  * Example prompts for test runs, releases, manual runs, and exploratory sessions
</Callout>

TestDino MCP Server connects AI assistants to your TestDino workspace to query test run data, artifacts, and manual test cases in natural language.

## Pick a connection method

TestDino offers two ways to connect. Pick whichever fits your client and workflow.

| Path                             | Best for                                       | Auth                           |
| :------------------------------- | :--------------------------------------------- | :----------------------------- |
| [Local MCP Server](/mcp/local)   | Claude Code, Cursor, Claude Desktop            | PAT in client config           |
| [Remote MCP Server](/mcp/remote) | ChatGPT, Claude on the web, other web AI tools | OAuth, scoped through TestDino |

### Local MCP Server

For Claude Code, Cursor, or Claude Desktop. Install on your machine, paste a token, and connect.

<img src="https://testdinostr.blob.core.windows.net/docs/docs/index/local-mcp-server.webp" alt="TestDino Local MCP Server setup for Claude Code, Cursor, and Claude Desktop with a token in the client config" />

[Set up the Local MCP Server <Icon icon="arrow-right" size={14} />](/mcp/local)

### Remote MCP Server

For ChatGPT, Claude on the web, and other AI tools that support remote MCP. No install, authorized over OAuth.

<img src="https://testdinostr.blob.core.windows.net/docs/docs/index/remote-mcp-server.webp" alt="TestDino Remote MCP Server connection for ChatGPT and Claude on the web using OAuth, with no local install" />

[Set up the Remote MCP Server <Icon icon="arrow-right" size={14} />](/mcp/remote)

<Tip>
  Want to query TestDino from Slack, Telegram, Discord, or WhatsApp instead of an IDE? The [OpenClaw chat bot integration](/integrations/communication/openclaw) wraps the Local MCP server as a chat bot.
</Tip>

## Example Prompts

<iframe className="w-full rounded-lg" style={{ height:"400px" }} src="https://www.youtube.com/embed/Qg4e0kEHVK0" title="TestDino MCP Example" allow="accelerometer;  clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />

### Test Run Analysis

| Prompt                                                         | What it does                                   |
| :------------------------------------------------------------- | :--------------------------------------------- |
| *Show test runs within the last hour in project xyz*           | Lists recent runs with status and metadata     |
| *Which are the most flaky test cases from the recent 10 runs?* | Ranks tests by flaky rate across runs          |
| *Show me all failed tests from the last run*                   | Filters test cases by failure status           |
| *List flaky tests on main from the last 7 days*                | Flaky tests filtered by branch and time window |
| *Show tests tagged @auth, @smoke that failed in production*    | Filters by tag, status, and environment        |
| *Debug the test case "visual.spec.js" on development*          | Root cause analysis with fix suggestions       |
| *Summarize which test broke in branch "main"*                  | Quick failure summary for a branch             |

### Manual Test Case Management

| Prompt                                                        | What it does                               |
| :------------------------------------------------------------ | :----------------------------------------- |
| *List all critical priority test cases in the checkout suite* | Filters manual cases by priority and suite |
| *Find manual test cases tagged @auth that are not automated*  | Filters by tag and automation status       |
| *Show me the steps for test case TC-456*                      | Full test case details including steps     |
| *Create a new test case for password reset in Authentication* | Creates a case in the specified suite      |
| *Update TC-789 to change its status to deprecated*            | Updates fields on an existing case         |
| *Create a test suite called "Payment Processing"*             | Creates a new suite for organizing cases   |

### Releases

| Prompt                                          | What it does                                               |
| :---------------------------------------------- | :--------------------------------------------------------- |
| *List all sprints in project xyz*               | Lists releases filtered by type `sprint`                   |
| *Show me the details for release MS-12*         | Returns dates, status, and progress stats for that release |
| *Create a Q3 regression sprint starting July 1* | Creates a sprint release with a start date                 |
| *Mark MS-8 as completed*                        | Updates the release's completed flag                       |

### Manual Test Runs

| Prompt                                            | What it does                                 |
| :------------------------------------------------ | :------------------------------------------- |
| *List all active manual test runs in project xyz* | Returns open runs with status and progress   |
| *Show me the test cases in run RUN-12*            | Lists per-case execution records in that run |
| *Create a smoke test run for the v2.1 release*    | Creates a run scoped to a release            |
| *Mark TC-45 as passed in run RUN-7*               | Updates a single test case result            |

### Exploratory Sessions

| Prompt                                                                                                        | What it does                                                |
| :------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------- |
| *List open exploratory sessions in project xyz*                                                               | Returns active sessions with assignees and state            |
| *Show me session SES-4*                                                                                       | Returns session details including mission and linked issues |
| *Create an exploratory session for the checkout flow assigned to [alex@example.com](mailto:alex@example.com)* | Creates a session with a mission and assignee               |
| *Close session SES-9*                                                                                         | Closes an exploratory session                               |

## Next Steps

<CardGroup cols={2}>
  <Card title="Tools Reference" icon="wrench" href="/mcp/tools-reference">
    Full parameters, input schemas, and video demos for every tool
  </Card>

  <Card title="Troubleshooting" icon="screwdriver-wrench" href="/mcp/troubleshooting">
    Error messages, fixes, and editor-specific solutions
  </Card>
</CardGroup>
