Skip to main content

mcptest

Automated testing for MCP servers. Like pytest, but for your tools.

PyPI License: MIT CI

Install

pip install mcptest-py

Quick start

# mcptest.yml
server:
  command: python my_server.py

tests:
  - name: "search works"
    tool: search_files
    input: { query: "hello" }
    assert:
      - status: success
      - result.length: "> 0"
$ mcptest run
✓ search works    search_files    45ms    2/2
1 passed · 45ms

Commands

mcptest run      # execute YAML test suite
mcptest audit    # auto-discover tools and check schema quality
mcptest check    # server health check (A–F grade)
mcptest init     # scaffold mcptest.yml from server's tool schemas

Full docs →

Metadata

Release files for mcptest-py 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcptest-py 0.1.0
File Size Uploaded Provenance Actions
mcptest_py-0.1.0.tar.gz 28.8 kB Without provenance Details for mcptest_py-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcptest-py 0.1.0
File Interpreter ABI Platform Actions
mcptest_py-0.1.0-py3-none-any.whl Python 3 none any Details for mcptest_py-0.1.0-py3-none-any.whl

Total release size: 42.6 kB

Release files / mcptest_py-0.1.0.tar.gz

Download URL mcptest_py-0.1.0.tar.gz
Size 28.8 kB
Tags Source
SHA-256 checksum
How to use checksums
91e25651ed0362f4ca65881fcaf09587d5ca2975c4db0bdda9eb3077d653be9c
BLAKE2b-256 checksum
How to use checksums
adeb1b612b6c1b3359b733b984d1ee501ed18515f51361f0aa31efa0ce29d5ad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.5

Release files / mcptest_py-0.1.0-py3-none-any.whl

Download URL mcptest_py-0.1.0-py3-none-any.whl
Size 13.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
484e643adfa249d2a045c9a98e980ab394d9b828e2ee6b02879855094a2ff102
BLAKE2b-256 checksum
How to use checksums
57e1f02b6d6a5227ba3b32606e52753b4fc44ba1404667745b150c7064890ab2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.5

Security for mcptest-py 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page