Tox Testing MCP Server

An MCP server that executes tox commands to run python tests within a project using pytest

Local serverstdioPython

What is the Tox Testing MCP server?

An MCP server that executes tox commands to run python tests within a project using pytest. That is what the tox testing mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The tools it exposes

The server publishes 11 tools. What each one is for:

  • run_tox_tests — Execute tox tests with various modes and options
  • all — Run all tests or tests from a specific group
  • file — Run tests from a specific file
  • case — Run a specific test case
  • directory — Run all tests in a specified directory
  • clients — Client-related tests
  • api — API endpoint tests
  • auth — Authentication tests
  • uploads — Upload functionality tests
  • routes — Route handler tests
  • Tools — The Tools tool exposed by this server

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client.

What it needs from you

Configuration is passed through the environment: TOX_APP_DIR, TOX_TIMEOUT. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

Among the file and storage access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Tox Testing's toolset — run_tox_tests, all, file and 8 more — is a fair guide to whether it matches your workflow. It is maintained by that1guy15; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Tox Testing's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 11 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Tox Testing.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
run_tox_testsExecute tox tests with various modes and options
allRun all tests or tests from a specific group
fileRun tests from a specific file
caseRun a specific test case
directoryRun all tests in a specified directory
clientsClient-related tests
apiAPI endpoint tests
authAuthentication tests
uploadsUpload functionality tests
routesRoute handler tests
ToolsThe Tools tool exposed by this server.

Configuration

VariableDescriptionRequired
TOX_APP_DIRFilesystem location the server is allowed to use.Optional
TOX_TIMEOUTConfiguration value read at startup.Optional

Example prompts to try

  • Use Tox Testing to run tox tests.
  • Use Tox Testing to all.
  • Use Tox Testing to file.

Frequently asked questions

It connects Tox Testing to MCP-compatible AI assistants such as Claude and Cursor, exposing 11 tools (run_tox_tests, all, file, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Tox Testing directly.