How do I use MCP Test Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Test Server Add 10 and 20" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Test Server

by agentspan-ai

Overview Schema Related Servers Score Discussions

Python

Remote

IMPORTANT

Final release. Maintained releases of mcp-testkit ended with the Agentspan → Orkes Conductor merge (August 17, 2026). This repository is archived read-only; pip install mcp-testkit keeps working and the server remains a usable generic MCP test harness as-is.

MCP Test Server

A Python MCP server with 65 deterministic tools across 8 groups, supporting stdio, HTTP, and REST API transports. Built for consistent, repeatable MCP protocol testing.

Install

pip install mcp-testkit

Or from source:

git clone https://github.com/agentspan-ai/mcp-testkit.git
cd mcp-testkit
pip install -e .

Related MCP server: mcp-test-server

Quick Start

# stdio (default)
mcp-testkit

# SSE + REST API on port 3001
mcp-testkit --transport http

# With bearer token authentication
mcp-testkit --transport http --auth super_secret_key

# Custom host/port
mcp-testkit --transport http --host 0.0.0.0 --port 8080

Transports

Transport	Command	Endpoints
stdio	`mcp-testkit`	MCP JSON-RPC over stdin/stdout
HTTP	`mcp-testkit --transport http`	MCP at `/mcp` + REST at `/api/*` + OpenAPI at `/api-docs`

Authentication

Pass --auth <key> to require a Bearer token on all requests (both MCP SSE and REST):

mcp-testkit --transport http --auth my_secret

# Clients must include:
# Authorization: Bearer my_secret

Tools (65 total)

All tools are deterministic — same input always produces same output. No randomness, no current time, no external state.

Math (8 tools)

Tool	Params	Description
`math_add`	`a`, `b`	Add two numbers
`math_subtract`	`a`, `b`	Subtract b from a
`math_multiply`	`a`, `b`	Multiply two numbers
`math_divide`	`a`, `b`	Divide (errors on zero)
`math_modulo`	`a`, `b`	Remainder (errors on zero)
`math_power`	`base`, `exponent`	Exponentiation
`math_factorial`	`n`	n! (errors on negative)
`math_fibonacci`	`n`	Nth Fibonacci number (0-indexed)

String (8 tools)

Tool	Params	Description
`string_reverse`	`text`	Reverse a string
`string_uppercase`	`text`	Convert to uppercase
`string_lowercase`	`text`	Convert to lowercase
`string_length`	`text`	Character count
`string_char_count`	`text`, `char`	Count occurrences
`string_replace`	`text`, `old`, `new`	Replace all occurrences
`string_split`	`text`, `delimiter`	Split by delimiter
`string_join`	`items`, `delimiter`	Join list with delimiter

Collection (8 tools)

Tool	Params	Description
`collection_sort`	`items`, `reverse?`	Sort a list
`collection_flatten`	`items`	Recursively flatten nested lists
`collection_merge`	`dict_a`, `dict_b`	Merge dicts (b wins on conflict)
`collection_filter_gt`	`items`, `threshold`	Filter numbers > threshold
`collection_unique`	`items`	Remove duplicates (order preserved)
`collection_group_by`	`items`, `key`	Group objects by key
`collection_zip`	`list_a`, `list_b`	Zip into list of pairs
`collection_chunk`	`items`, `size`	Split into chunks

Encoding (8 tools)

Tool	Params	Description
`encoding_base64_encode`	`text`	Base64 encode
`encoding_base64_decode`	`data`	Base64 decode
`encoding_url_encode`	`text`	URL-encode
`encoding_url_decode`	`text`	URL-decode
`encoding_hex_encode`	`text`	Hex encode
`encoding_hex_decode`	`data`	Hex decode
`encoding_md5`	`text`	MD5 hash
`encoding_sha256`	`text`	SHA-256 hash

DateTime (8 tools)

All operate on provided dates — never use current time.

Tool	Params	Description
`datetime_parse`	`date_string`	Parse ISO date to components
`datetime_format`	`year`, `month`, `day`, `format`	Format date to string
`datetime_add_days`	`date_string`, `days`	Add/subtract days
`datetime_diff`	`date_a`, `date_b`	Days between two dates
`datetime_day_of_week`	`date_string`	Weekday name
`datetime_is_leap_year`	`year`	Leap year check
`datetime_days_in_month`	`year`, `month`	Days in month
`datetime_week_number`	`date_string`	ISO week number

Validation (8 tools)

All return {valid: bool, reason: string}.

Tool	Params	Description
`validation_is_email`	`text`	Email format check
`validation_is_url`	`text`	URL format check
`validation_is_ipv4`	`text`	IPv4 address check
`validation_is_ipv6`	`text`	IPv6 address check
`validation_is_uuid`	`text`	UUID format check
`validation_is_json`	`text`	Valid JSON check
`validation_is_palindrome`	`text`	Palindrome check
`validation_matches_regex`	`text`, `pattern`	Regex match check

Conversion (8 tools)

Tool	Params	Description
`conversion_celsius_to_fahrenheit`	`value`	C to F
`conversion_fahrenheit_to_celsius`	`value`	F to C
`conversion_km_to_miles`	`value`	km to miles
`conversion_miles_to_km`	`value`	miles to km
`conversion_bytes_to_human`	`bytes`	Bytes to human string
`conversion_rgb_to_hex`	`r`, `g`, `b`	RGB to hex color
`conversion_hex_to_rgb`	`hex_color`	Hex to RGB
`conversion_decimal_to_binary`	`value`	Decimal to binary string

Echo / Protocol Testing (8 tools)

Tool	Params	Description
`echo`	`message`	Echo input unchanged
`echo_error`	`message`	Always raises ToolError
`echo_large`	`size_kb`	Deterministic ~N KB text
`echo_nested`	`depth`	Nested JSON to depth N
`echo_types`	—	All JSON types
`echo_empty`	—	Empty string
`echo_multiple`	`messages`	Multiple TextContent blocks
`echo_schema`	`str_param`, `int_param`, `float_param`, `bool_param`, `list_param`, `obj_param`	Complex schema test

Standalone

Tool	Params	Description
`get_weather`	`city`	Fixed response: 77°F, sunny, always

REST API

When running with --transport http, all tools are also available as HTTP endpoints:

# GET endpoints (math, conversion, some echo, weather)
curl "http://localhost:3001/api/math/add?a=3&b=5"
# {"result": 8.0}

curl "http://localhost:3001/api/weather?city=NYC"
# {"city":"NYC","temperature_f":77,...}

# POST endpoints (string, collection, encoding, datetime, validation, some echo)
curl -X POST "http://localhost:3001/api/string/reverse" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello"}'
# {"result": "olleh"}

curl -X POST "http://localhost:3001/api/encoding/sha256" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello"}'
# {"result": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"}

OpenAPI spec at GET /api-docs (OpenAPI 3.0.3).

With auth enabled, include Authorization: Bearer <key> on all requests.

Testing

python3 -m pytest tests/ -v

389 tests covering all tools, REST API endpoints, auth, OpenAPI spec, and integration.

Project Structure

mcp-testkit/
├── pyproject.toml              # Package config, deps, CLI entry point
├── mcp_test_server/
│   ├── __init__.py             # Package version
│   ├── server.py               # Entry point — MCP server + REST API + auth
│   ├── api.py                  # REST API routes + OpenAPI spec generation
│   └── tools/
│       ├── __init__.py         # Tool group registry
│       ├── math_tools.py
│       ├── string_tools.py
│       ├── collection_tools.py
│       ├── encoding_tools.py
│       ├── datetime_tools.py
│       ├── validation_tools.py
│       ├── conversion_tools.py
│       └── echo_tools.py      # Includes get_weather
└── tests/
    ├── test_math_tools.py
    ├── test_string_tools.py
    ├── test_collection_tools.py
    ├── test_encoding_tools.py
    ├── test_datetime_tools.py
    ├── test_validation_tools.py
    ├── test_conversion_tools.py
    ├── test_echo_tools.py
    ├── test_api.py
    └── test_integration.py

This server cannot be installed

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

2moRelease cycle

3Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

MCP Everything
Code Execution Testing & QA Tools
s2005
A
license
Not graded
quality
D
maintenance
A test server implementing all features of the MCP protocol, including prompts, tools, resources, and sampling, designed for testing MCP clients rather than practical applications.
Updated a year ago (2025-05-24 08:55 UTC)
MIT
mcp-test-server
Developer Tools Testing & QA Tools
kukapay
A
license
Not graded
quality
D
maintenance
A lightweight MCP test server for verifying client connectivity, providing tools, resources, and prompts for integration.
Updated a year ago (2025-07-03 15:26 UTC)
12
ISC
my-mcp
Developer Tools Code Execution
kcbabo
F
license
B
quality
D
maintenance
An MCP server framework featuring dynamic tool loading and a modular one-tool-per-file architecture for rapid development. It supports both Stdio and HTTP transport modes, offering automated test generation and centralized configuration management.
Updated 3 months ago (2026-05-21 19:55 UTC)
11
Des MCP Server Testing MCP
Testing & QA Tools API Testing Developer Tools
Traia-IO
F
license
Not graded
quality
D
maintenance
A standardized MCP server designed for testing integration with the Des MCP Server Testing API. It allows AI agents to interact with testing endpoints using tools implemented via the Model Context Protocol.
Updated 5 months ago (2026-03-16 10:11 UTC)

View all related MCP servers

Related MCP Connectors

meok-mcp-test-mcp
MEOK MCP Test MCP — golden-file + schema-drift + tool-failure tests for any MCP server. Drop-in
MCP Verification Gate: conformance and disclosure checker for MCP servers
Conformance checker for MCP servers. Free, no key, verdicts recomputable and re-measured daily.
SmartBear MCP
MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/agentspan-ai/mcp-testkit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

MCP Test Server

Install

Quick Start

Transports

Authentication

Tools (65 total)

Math (8 tools)

String (8 tools)

Collection (8 tools)

Encoding (8 tools)

DateTime (8 tools)

Validation (8 tools)

Conversion (8 tools)

Echo / Protocol Testing (8 tools)

Standalone

REST API

Testing

Project Structure

Maintenance

Resources

Looking for Admin?

Related MCP Servers

MCP Everything

mcp-test-server

my-mcp

Des MCP Server Testing MCP

Related MCP Connectors

Latest Blog Posts

MCP directory API