Test MCP Server

curl -X POST https://api.leanmcp.com/v1/test \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mcp_id": "mcp_abc123def456",
    "message": "Send an email to john@example.com saying hello",
    "ai_model": "claude-sonnet-4-5",
    "context": {
      "user_id": "user_123"
    }
  }'

{
  "success": true,
  "data": {
    "ai_response": "I've sent an email to john@example.com with the subject 'Hello' and a friendly greeting message.",
    "tools_used": ["send_email"],
    "resources_accessed": ["user://contacts"],
    "execution_time": 2.3,
    "success_rate": 1.0
  },
  "meta": {
    "request_id": "req_test_789",
    "timestamp": "2023-12-01T12:00:00Z"
  }
}

POST

test

curl -X POST https://api.leanmcp.com/v1/test \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mcp_id": "mcp_abc123def456",
    "message": "Send an email to john@example.com saying hello",
    "ai_model": "claude-sonnet-4-5",
    "context": {
      "user_id": "user_123"
    }
  }'

{
  "success": true,
  "data": {
    "ai_response": "I've sent an email to john@example.com with the subject 'Hello' and a friendly greeting message.",
    "tools_used": ["send_email"],
    "resources_accessed": ["user://contacts"],
    "execution_time": 2.3,
    "success_rate": 1.0
  },
  "meta": {
    "request_id": "req_test_789",
    "timestamp": "2023-12-01T12:00:00Z"
  }
}

Test how AI agents interact with your MCP server.

Request

string

required

ID of the MCP server to test

string

required

Message to send to the AI agent

string

AI model to use for testing. Options: claude-sonnet-4-5, gpt-5.2, gpt-5.2 Default: claude-sonnet-4-5

object

Additional context for the AI agent

Show Context Object

string

User ID for resource access

object

Session-specific data

Response

boolean

Whether the test completed successfully

object

Show Test Results

string

The AI agent’s response

array

List of tools the AI called

array

List of resources the AI accessed

number

Test execution time in seconds

number

Success rate of tool calls (0-1)

curl -X POST https://api.leanmcp.com/v1/test \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mcp_id": "mcp_abc123def456",
    "message": "Send an email to john@example.com saying hello",
    "ai_model": "claude-sonnet-4-5",
    "context": {
      "user_id": "user_123"
    }
  }'

{
  "success": true,
  "data": {
    "ai_response": "I've sent an email to john@example.com with the subject 'Hello' and a friendly greeting message.",
    "tools_used": ["send_email"],
    "resources_accessed": ["user://contacts"],
    "execution_time": 2.3,
    "success_rate": 1.0
  },
  "meta": {
    "request_id": "req_test_789",
    "timestamp": "2023-12-01T12:00:00Z"
  }
}

Testing Best Practices

Start Simple

Test basic tool usage first:

{
  "mcp_id": "your-mcp-id",
  "message": "What tools do you have available?",
  "ai_model": "claude-sonnet-4-5"
}

Test Edge Cases

Try confusing or ambiguous requests:

{
  "mcp_id": "your-mcp-id", 
  "message": "Do that thing with the data",
  "ai_model": "claude-sonnet-4-5"
}

Test Complex Workflows

Chain multiple tool calls together:

{
  "mcp_id": "your-mcp-id",
  "message": "Check my contacts, find John's email, and send him a meeting invite for tomorrow at 2pm",
  "ai_model": "claude-sonnet-4-5"
}

Overview

Projects

Deployments

Test MCP Server

Request

Response

Testing Best Practices

Start Simple

Test Edge Cases

Test Complex Workflows

Interpreting Results

Success Rate

Common Issues

​Request

​Response

​Testing Best Practices

​Start Simple

​Test Edge Cases

​Test Complex Workflows

​Interpreting Results

​Success Rate

​Common Issues

Request

Response

Testing Best Practices

Start Simple

Test Edge Cases

Test Complex Workflows

Interpreting Results

Success Rate

Common Issues