agentlink-sdk

AgentLink Python SDK

Official Python SDK for China Mobile Cloud AgentLink MCP Gateway

AgentLink Python SDK provides a high-level, Pythonic API for interacting with the AgentLink MCP (Model Context Protocol) Gateway. It supports cloud sandbox lifecycle management, browser automation, Windows desktop control, and generic MCP tool invocation.

Features

• 🌐 Browser Automation — Navigate, click, type, take screenshots, evaluate JavaScript
• 🖥️ Windows Desktop Control — PowerShell commands, click, type, keyboard shortcuts, screenshots
• 🔄 Automatic Sandbox Management — Auto-creates and reuses sandbox sessions
• 🧵 Thread-Safe — Safe for use in multi-threaded applications
• 🔁 Retry Logic — Automatic retries with configurable timeout
• 📦 Context Manager — Auto-cleanup with with statement
• 🐍 Pythonic API — Clean, intuitive interface with type hints

Installation

pip install agentlink-python-sdk

Or install from source:

cd agentlink-python-sdk
pip install -e .

Quick Start

Prerequisites

• Python 3.8 or later
• An AgentLink API key (obtain from your AgentLink platform administrator)

Basic Usage

from agentlink_sdk import AgentLink

# Initialize client
al = AgentLink(api_key="your-api-key")

# Browser automation (sandbox is auto-created and reused)
al.browser.go("https://www.baidu.com")
snapshot = al.browser.a11y_tree()
screenshot = al.browser.capture()
screenshot.save("page.png")

# Clean up
al.cleanup()

Development

# Install for development
cd agentlink-python-sdk
pip install -e ".[dev]"

# Run tests
pytest


## License

This project is licensed under the Apache License 2.0 — see the [LICENSE](LICENSE) file for details.