{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_prrfrgsp4u8u","handle":"agentsphere-mcp-server","url":"https://wellknown.network/agents/agentsphere-mcp-server","links":{"self":"https://wellknown.network/agents/agentsphere-mcp-server/record.json","html":"https://wellknown.network/agents/agentsphere-mcp-server","markdown":"https://wellknown.network/agents/agentsphere-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/agentsphere-mcp-server","status":"https://wellknown.network/api/v1/agents/agentsphere-mcp-server/status","claim":"https://wellknown.network/agents/agentsphere-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/agentsphere-mcp-server/claim.json","badge":"https://wellknown.network/agents/agentsphere-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:agentsphere-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"agentsphere-mcp-server","summary":"mcp server for agentsphere sandbox","description":"# PTY Create Function for MCP Server\n\nThis implementation provides a cross-platform `pty_create(sandbox_id: str)` function for MCP (Model Context Protocol) servers, enabling terminal interaction with sandboxes.\n\n## Features\n\n- ✅ **Cross-platform support**: Works on macOS and Windows\n- ✅ **Optional sandbox_id parameter**: Reuse existing sandboxes or create new ones\n- ✅ **MCP protocol integration**: Full server/client implementation\n- ✅ **Async/await support**: Non-blocking terminal operations\n- ✅ **Session management**: Create, manage, and close multiple terminal sessions\n- ✅ **Backward compatibility**: Works even without agentsphere package\n\n## Installation\n\n```bash\n# Install basic dependencies\npip install -r requirements.txt\n\n# Install agentsphere for full functionality (optional)\npip install agentsphere\n```\n\n## Quick Start\n\n### Basic Usage\n\n```python\nfrom pty_create import pty_create, get_terminal_session\n\n# Create a new PTY session\nsession_id = pty_create()\nprint(f\"Session ID: {session_id}\")\n\n# Get session object\nsession = get_terminal_session(session_id)\n\n# Write to terminal\nsession.write(b\"ls -la\\n\")\n\n# Read from terminal\noutput = await session.read()\nprint(f\"Output: {output}\")\n\n# Close session\nawait close_terminal_session(session_id)\n```\n\n### With Specific Sandbox\n\n```python\n# Create PTY session with specific sandbox\nsession_id = pty_create(\"sandbox_123\")\n```\n\n### Simple Terminal Mode (without agentsphere)\n\nThe function works even without the agentsphere package, providing a simple terminal interface:\n\n```python\n# This will work even without agentsphere\nsession_id = pty_create()\nsession = get_terminal_session(session_id)\n```\n\n## MCP Server Integration\n\n### Running the Server\n\n```bash\n# Start the MCP server\npython examples/server_example.py server\n```\n\n### Client Connection\n\n```python\nfrom mcp_terminal import MCPClient\n\n# Connect to server\nclient = MCPClient(host=\"localhost\", port=8001)\nawait client.connect()\n\n# Create session\nsession_id = await client.pty_cre…","publisher":null,"homepage":"https://www.agentsphere.run/home","repository":null,"version":"1.9.1","license":"MIT License  Copyright (c) 2025 iSoftStone, INC.  Copyright (c)…","protocols":["mcp"],"tags":["agentsphere","mcp","sandbox"],"pricing":null,"endpoints":[{"url":"pypi:agentsphere-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"code.execution","name":"Code Execution","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"provenance":"derived"}],"categories":["code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"agentsphere-mcp-server","registry":"pypi","observedAt":"2026-09-09T08:22:35.405Z","publishedAt":"2025-11-17T09:08:10.466087Z","latestVersion":"1.9.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"agentsphere-mcp-server","url":"https://pypi.org/project/agentsphere-mcp-server/","firstSeenAt":"2026-09-09T08:21:19.937Z","fetchedAt":"2026-09-09T08:21:19.937Z","normalizedAt":"2026-09-09T08:21:19.937Z"}]},"firstSeenAt":"2026-09-09T08:21:19.937Z","updatedAt":"2026-09-09T08:22:35.405Z"}