chore: sync from monorepo v0.10.0-sync-test

Author: AgentSIM

README.md

@@ -1,32 +1,8 @@
-<p align="center">
-  <a href="https://agentsim.dev">
-    <img src="https://agentsim.dev/logo.svg" alt="AgentSIM" width="80" />
-  </a>
-</p>
+# agentsim-mcp
 
-<h1 align="center">agentsim-mcp</h1>
+<!-- mcp-name: dev.agentsim/mcp -->
 
-<p align="center">
-  <strong>MCP server for AgentSIM — give AI coding assistants real phone numbers</strong>
-</p>
-
-<p align="center">
-  <a href="https://pypi.org/project/agentsim-mcp/"><img src="https://img.shields.io/pypi/v/agentsim-mcp?color=%2334D058&label=pypi" alt="PyPI version"></a>
-  <a href="https://www.npmjs.com/package/@agentsim/mcp-server"><img src="https://img.shields.io/npm/v/@agentsim/mcp-server?color=%2334D058&label=npm" alt="npm version"></a>
-  <a href="https://github.com/agentsimdev/agentsim-mcp/blob/main/LICENSE"><img src="https://img.shields.io/github/license/agentsimdev/agentsim-mcp" alt="License"></a>
-</p>
-
-<p align="center">
-  <a href="https://docs.agentsim.dev/mcp">Docs</a> ·
-  <a href="https://agentsim.dev/dashboard">Dashboard</a> ·
-  <a href="https://github.com/agentsimdev/agentsim-examples">Examples</a>
-</p>
-
----
-
-MCP server that exposes AgentSIM phone number tools to AI coding assistants. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible host.
-
-Real SIM-backed numbers. No VoIP. Carrier lookup returns `mobile`.
+MCP server that exposes AgentSIM phone number tools to AI coding assistants — Claude Code, Cursor, Windsurf, and any other MCP-compatible host.
 
 ## Setup
 
@@ -60,7 +36,7 @@ Add `agentsim-mcp` as a stdio MCP server with `AGENTSIM_API_KEY` in the environm
 
 ### Remote (no install)
 
-Connect directly to the hosted server — no local installation required:
+Connect directly to the hosted MCP server without installing anything locally:
 
 ```json
 {
@@ -80,62 +56,16 @@ Connect directly to the hosted server — no local installation required:
 
 | Tool | Description |
 |------|-------------|
-| `provision_number` | Lease a real mobile phone number — returns number + session ID |
-| `wait_for_otp` | Long-poll until an OTP arrives (returns parsed code) |
+| `provision_number` | Provision a phone number for an agent — returns number, session ID, expiry |
+| `wait_for_otp` | Long-poll until an OTP arrives on the session (returns parsed code) |
 | `get_messages` | List raw SMS messages received on a session |
 | `release_number` | Release a session early (number returned to pool) |
-| `list_numbers` | List all active sessions for your account |
-
-### Typical Workflow
+| `list_numbers` | List all active sessions for this account |
 
-```
-1. provision_number  →  get phone number + session_id
-2. Use the number on target service to trigger SMS
-3. wait_for_otp      →  get the OTP code
-4. Use the OTP in your workflow
-5. release_number    →  return number to pool
-```
-
-If `wait_for_otp` returns `status=carrier_retry_required`, a replacement number has been provisioned on the same session. Re-enter the new number on the target service, then call `wait_for_otp` again.
-
-## Authentication
+## Auth
 
 Set `AGENTSIM_API_KEY` in your environment. Get your key at [agentsim.dev/dashboard](https://agentsim.dev/dashboard).
 
-## Self-Hosting
-
-### Docker / Railway
-
-```toml
-# railway.toml
-[build]
-builder = "nixpacks"
-
-[deploy]
-startCommand = "python -m agentsim_mcp.server --http"
-healthcheckPath = "/health"
-```
-
-### Manual
-
-```bash
-pip install agentsim-mcp
-AGENTSIM_API_KEY=asm_live_xxx agentsim-mcp --sse
-```
-
-## Pricing
-
-- **Hobby**: 10 free sessions/month
-- **Builder**: $0.99/session
-- Sessions that time out are **not billed**
-
-## Links
-
-- [Documentation](https://docs.agentsim.dev/mcp)
-- [Python SDK](https://github.com/agentsimdev/agentsim-python)
-- [TypeScript SDK](https://github.com/agentsimdev/agentsim-typescript)
-- [Examples](https://github.com/agentsimdev/agentsim-examples)
-
-## License
+## Supported Countries
 
-[MIT](LICENSE)
+US (more coming soon)

npm/package.json

@@ -6,7 +6,8 @@
   "homepage": "https://agentsim.dev",
   "repository": {
     "type": "git",
-    "url": "https://github.com/agentsimdev/agentsim-mcp"
+    "url": "https://github.com/agentsimdev/agentsim",
+    "directory": "mcp"
   },
   "license": "MIT",
   "bin": {

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentsim-mcp"
-version = "0.9.0"
+version = "0.10.0"
 description = "AgentSIM MCP server — phone number provisioning tools for AI coding assistants"
 readme = {text = "<!-- mcp-name: dev.agentsim/mcp -->\n\nReal SIM-backed phone numbers for AI agents. Provision a number, receive OTP codes, release — in 3 API calls. No VoIP. Carrier lookup returns `mobile`.\n\nSee [agentsim.dev](https://agentsim.dev) for documentation.", content-type = "text/markdown"}
 requires-python = ">=3.11"
@@ -41,3 +41,5 @@ packages = ["agentsim_mcp"]
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
+
+# sync-test: 2026-03-28T08:39:31Z