MCPClientLibrary Documentation

Robot Framework library for testing MCP (Model Context Protocol) servers.

Contents:

• Overview
  • What is MCPClientLibrary?
  • Key Features
  • Why Use It?
  • Example
  • Supported Platforms
  • Next Steps
• Installation
  • Requirements
  • Install from PyPI
  • Verify Installation
  • Develop from Source
• Quick Start
  • Your First Test (5 Minutes)
• Keywords
  • Connection Lifecycle
  • Tools
  • Tool Assertions
  • Tool Result Assertions
  • Resources
  • Resource Assertions
  • Prompts
  • Prompt Assertions
  • Output Schema Validation
  • Progress Capture
  • Server Log Capture
  • Resource Subscriptions
  • Client Callbacks
  • Common Options
• Architecture
  • The core problem
  • The session as a long-lived task
  • One request, end to end
  • Why this makes concurrent calls to different servers work
  • Where each transport fits in
  • Cross-thread state and why it’s safe
• Troubleshooting
  • Server process won’t start
  • Timeout errors
  • Protocol errors
  • A server that crashes mid-call
  • Empty tool/resource/prompt lists
  • Schema-related errors
  • Deprecation warnings from the MCP SDK
  • Concurrency surprises
  • Still stuck?

Overview

MCPClientLibrary lets you write Robot Framework tests for MCP servers without async code. Start the server, call its tools, resources, and prompts, and assert on what it returns.

See Overview for the full picture, or the GitHub repository and its README for source code.

Keyword Documentation

View the full keyword reference: MCPClientLibrary.html

This is auto-generated by Robot Framework’s Libdoc tool and includes all 62 keywords with detailed descriptions, arguments, and examples.