@oneshot-agent/mcp-server 0.27.0 → 0.28.0

package/README.md

@@ -1,6 +1,12 @@
 # @oneshot-agent/mcp-server
 
-MCP (Model Context Protocol) server for [OneShot](https://oneshotagent.com) - enabling AI agents to execute commercial actions.
+MCP (Model Context Protocol) server for [OneShot](https://oneshotagent.com). It gives any MCP client (Claude Desktop, Cursor, Claude Code) OneShot's tools: email, calls, SMS, research, enrichment, commerce, website builds. Paid calls are charged one at a time and show up in your receipts. An optional daily budget caps the spend.
+
+Quick start:
+
+1. Install the server (below).
+2. Add it to your client's MCP config with CDP credentials ([Configuration](#configuration)).
+3. Send USDC on Base to the agent's wallet ([Funding Your Agent](#funding-your-agent)).
 
 ## Installation
 
@@ -10,7 +16,7 @@ npm install -g @oneshot-agent/mcp-server
 
 ## Configuration
 
-The server supports three auth methods: **CDP Wallet** (recommended, no private keys in config), a raw private key, or an **access token** (credits-only session, no key at all — see Remote below).
+Pick one of three auth methods: **CDP Wallet** (recommended, no private keys in config), a raw private key, or an **access token** (credits-only session with no key; see Remote below).
 
 ### Environment Variables
 
@@ -87,16 +93,16 @@ Add to `~/.claude/settings.json`:
 }
 ```
 
-Get CDP credentials at [Coinbase Agentic Wallet](https://docs.cdp.coinbase.com/agentic-wallet/welcome). Or use `ONESHOT_WALLET_PRIVATE_KEY` instead of CDP env vars for raw key auth.
+Get CDP credentials at [Coinbase Agentic Wallet](https://docs.cdp.coinbase.com/agentic-wallet/welcome), or use `ONESHOT_WALLET_PRIVATE_KEY` instead of the CDP env vars for raw key auth.
 
 ### Read authentication
 
-Read tools (inbox, SMS inbox, notifications, balance, browser profiles) return private, per-agent data. The server wraps the OneShot TypeScript SDK, which automatically signs a short-lived **EIP-712 read proof** (`x-agent-proof`) on each read so the API can verify you control the `X-Agent-ID` wallet. No configuration needed — this ships via `@oneshot-agent/sdk >= 0.25.0` (the bundled dependency). Read-proof verification is rolling out in log-only mode server-side, so older callers keep working until enforcement is enabled.
+Read tools (inbox, SMS inbox, notifications, balance, browser profiles) return private, per-agent data. The server wraps the OneShot TypeScript SDK, which signs a short-lived **EIP-712 read proof** (`x-agent-proof`) on each read so the API can verify you control the `X-Agent-ID` wallet. This needs no configuration; it ships in `@oneshot-agent/sdk >= 0.25.0` (the bundled dependency). The server is rolling out read-proof verification in log-only mode, so older callers keep working until enforcement is enabled.
 
 ## Remote (hosted)
 
-Clients that run in someone else's cloud — Grok Bot, hosted runners — cannot spawn this
-server and must not hold a wallet key. For them OneShot hosts the same 73 tools over
+Clients that run in someone else's cloud (Grok Bot, hosted runners) cannot spawn this
+server and must not hold a wallet key. For them, OneShot hosts the same 73 tools over
 Streamable HTTP at **`https://win.oneshotagent.com/mcp`**, authenticated with an
 **agent access token** and billed to the agent's credit balance:
 
@@ -178,7 +184,7 @@ instead of the wallet variables for a credits-only session on your own machine.
 |------|-------------|
 | `oneshot_web_search` | Search the web |
 | `oneshot_web_read` | Read any URL as markdown + screenshot |
-| `oneshot_browser` | Autonomous browser — navigate, click, extract |
+| `oneshot_browser` | Autonomous browser: navigate, click, extract |
 
 ### Commerce
 
@@ -198,12 +204,12 @@ instead of the wallet variables for a credits-only session on your own machine.
 
 | Tool | Description |
 |------|-------------|
-| `oneshot_compute` | Create an autonomous goal — objective + budget, the orchestrator plans and executes |
+| `oneshot_compute` | Create an autonomous goal (objective + budget); the orchestrator plans and executes |
 | `oneshot_compute_status` | Get a compute goal's status and budget |
 | `oneshot_compute_tasks` | List tasks planned/executed under a goal |
 | `oneshot_compute_cancel` | Cancel a goal and refund remaining budget |
 | `oneshot_compute_respond` | Respond to a human-in-the-loop task |
-| `oneshot_compute_pause` | Pause a recurring goal — plan and progress are kept |
+| `oneshot_compute_pause` | Pause a recurring goal; plan and progress are kept |
 | `oneshot_compute_resume` | Resume a paused recurring goal |
 | `oneshot_compute_fund` | Top up a recurring goal's USDC budget |
 
@@ -233,7 +239,7 @@ instead of the wallet variables for a credits-only session on your own machine.
 | `oneshot_get_balance` | Get USDC wallet balance |
 | `oneshot_budget_status` | Today's spend vs the configured budget (read-only) |
 
-All paid tools are priced in USDC via the x402 protocol. See [Pricing](https://docs.oneshotagent.com/pricing) for current rates.
+Paid tools are priced in USDC via the x402 protocol. Current rates are on the [Pricing](https://docs.oneshotagent.com/pricing) page.
 
 ## Tool Examples
 
@@ -328,7 +334,16 @@ Use oneshot_inbox_list:
 
 ## Funding Your Agent
 
-Send USDC to your agent's wallet address on Base. The server operates on Base Mainnet (chain 8453).
+Send USDC to your agent's wallet address on Base. The server runs on Base Mainnet (chain 8453).
+
+## LinkedIn connection recovery
+
+If the active account list is empty or an account is `deleted_upstream` or
+`revoked`, ask the human to use `oneshot_linkedin_connect` and authorize fresh
+grants. An existing account with `reconnect_required` must be reconnected through
+the owning application. Reconnect and revoke are deliberately not agent tools.
+Do not create a new connection automatically after authentication failures or
+timeouts.
 
 ## Links
 
@@ -338,12 +353,3 @@ Send USDC to your agent's wallet address on Base. The server operates on Base Ma
 - [Python SDK (LangChain)](https://pypi.org/project/langchain-oneshot/)
 - [Python SDK (Core)](https://pypi.org/project/oneshot-python/)
 - [GitHub](https://github.com/oneshot-agent/sdk)
-
-### LinkedIn connection recovery
-
-If the active account list is empty or an account is `deleted_upstream` or
-`revoked`, ask the human to use `oneshot_linkedin_connect` and authorize fresh
-grants. An existing account with `reconnect_required` needs reconnect through
-the owning application. Reconnect and revoke are intentionally not agent tools.
-Do not automatically create a new connection in response to authentication
-failures or timeouts.

package/dist/index.js

@@ -52,7 +52,7 @@ async function main() {
     // Create MCP server
     const server = new Server({
         name: "oneshot-mcp",
-        version: "0.27.0", // keep in sync with package.json; guarded by version.test.ts
+        version: "0.28.0", // keep in sync with package.json; guarded by version.test.ts
     }, {
         capabilities: {
             tools: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "MCP server for OneShot - 73 tools for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -25,7 +25,7 @@
   "dependencies": {
     "@coinbase/cdp-sdk": "1.45.0",
     "@modelcontextprotocol/sdk": "1.27.1",
-    "@oneshot-agent/sdk": "^0.41.0",
+    "@oneshot-agent/sdk": "^0.42.0",
     "zod": "3.25.76"
   },
   "devDependencies": {