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

# mcp-t

> Get up and running with MCP Testing Framework in 5 minutes

# Quickstart Guide

## Prerequisites

Before testing, you'll need an MCP server to test against.

You'll also need:

* Python 3.11 or higher
* An Anthropic API key ([get one here](https://console.anthropic.com/))
* An OpenAI API key ([get one here](https://platform.openai.com/))

<Steps>
  <Step title="Install MCP Testing">
    ```bash theme={null}
    pip install mcp-testing
    ```
  </Step>

  <Step title="Set Up API Keys">
    Export your API keys as environment variables:

    ```bash theme={null}
    export ANTHROPIC_API_KEY="sk-ant-your_key_here"
    export OPENAI_API_KEY="sk-your_key_here"
    ```
  </Step>

  <Step title="Complete Interactive Onboarding">
    Run the interactive quickstart command:

    ```bash theme={null}
    mcp-t quickstart
    ```

    This command will:

    ### Show Setup Guide

    You'll see a comprehensive guide with all available commands and workflows.

    ### Validate Your API Keys

    The system checks that your `ANTHROPIC_API_KEY` is properly configured. If missing, you'll see:

    ```
    ❌ Missing ANTHROPIC_API_KEY environment variable

    Set up your API key:
      export ANTHROPIC_API_KEY=your_key_here
      # Get your API key: https://console.anthropic.com/
    ```

    ### Create Your First Configuration

    The quickstart will prompt you to create:

    **Server Configuration**:

    * Server ID (easy to remember, e.g., "my-server")
    * Server name (descriptive name)
    * Server URL (your MCP server endpoint)

    **Test Suite Configuration**:

    * Suite ID (easy to remember, e.g., "basic-tests")
    * Suite name (descriptive name)
    * Test cases with:
      * Test ID
      * User message (what the AI agent will say)
      * Success criteria (what constitutes a pass)

    ### Set Up Shell Completion

    Optionally configure tab completion for the CLI commands.
  </Step>

  <Step title="Run Your First Test">
    Now run the test suite you just created:

    ```bash theme={null}
    mcp-t run basic-tests my-server
    ```
  </Step>
</Steps>

## Next Steps

### Explore More Commands

```bash theme={null}
# List your configurations
mcp-t list

# Run compliance tests
mcp-t compliance my-server

# Run security tests  
mcp-t security my-server

# Create more test suites
mcp-t create suite

# Add more servers
mcp-t create server

# Generate test suites automatically
mcp-t generate
```

### Understand Your Results

Each test includes:

* **Conversation transcript** - Full dialogue between AI agent and your server
* **Judge evaluation** - LLM analysis of whether success criteria were met
* **Tool calls** - Which MCP tools were used during the conversation
* **Confidence score** - How confident the judge is in the verdict

### Learn Core Concepts

Now that you've run your first test, learn more about:

* [Testing Philosophy](../concepts/testing-philosophy) - Why test MCP servers this way?
* [Test Suites](../concepts/test-suites) - How to structure comprehensive tests

## Troubleshooting

Need more help? Check out our [troubleshooting guide](../troubleshooting/common) or [FAQ](../troubleshooting/faq).