contextwise 0.1.0 → 0.2.0

package/README.md

@@ -77,6 +77,38 @@ contextwise stats
 
 ## Quick Start
 
+### Fastest: hosted gateway (no install)
+
+Call ContextWise through the MCPaid edge — zero install, discovery free,
+cloud sync metered per use ($0.01 push / $0.005 pull, USDC on Base L2):
+
+```bash
+# One-shot / stdio bridge (works with any MCP client)
+npx -y @mcpaid/sdk bridge --gateway https://mcpaid.dev/mcp/contextwise
+```
+
+```bash
+# Claude Code
+claude mcp add contextwise -- npx -y @mcpaid/sdk bridge --gateway https://mcpaid.dev/mcp/contextwise
+```
+
+```json
+// Cursor (.cursor/mcp.json) or Claude Desktop — stdio entry
+{
+  "mcpServers": {
+    "contextwise": {
+      "command": "npx",
+      "args": ["-y", "@mcpaid/sdk", "bridge", "--gateway", "https://mcpaid.dev/mcp/contextwise"]
+    }
+  }
+}
+```
+
+No API keys, no signup for discovery. Paid sync calls return a `402` with
+funding instructions the first time; agents pay gaslessly via EIP-712 permits.
+
+### Self-host: local install
+
 ### 1. Installation
 
 Install globally via npm:
@@ -130,6 +162,38 @@ claude mcp add contextwise -- npx -y contextwise start
 }
 ```
 
+### 4. HTTP Mode (for MCPaid Publishing)
+
+Expose ContextWise over Streamable HTTP instead of stdio, then monetize per-call with MCPaid:
+
+```bash
+# 1. Serve ContextWise locally over HTTP
+npx contextwise start --http --port 3000
+# Listening on http://127.0.0.1:3000/mcp
+
+# 2. Publish to the MCPaid edge (pay-per-use USDC on Base L2)
+npx @mcpaid/sdk publish mcpaid.config.json
+# Live at https://mcpaid.dev/mcp/contextwise
+```
+
+Priced tools (`mcpaid.config.json`): `contextwise_cloud_push` $0.01/call,
+`contextwise_cloud_pull` $0.005/call; search, execute, browse, server setup,
+and sync status are free. No subscriptions — sync usage is metered through MCPaid instead.
+
+#### Downstream Edge Receipt Enforcement
+
+To protect your HTTP server from direct bypass and verify payments cryptographically:
+
+```bash
+# Get your server's receipt secret from MCPaid
+npx @mcpaid/sdk server receipt-secret contextwise
+
+# Export the secret on your host or deployment
+export MCPAID_RECEIPT_SECRET=mcpaid_sec_...
+```
+
+When `MCPAID_RECEIPT_SECRET` is set, ContextWise verifies `X-MCPaid-Receipt` on incoming HTTP requests for priced tools before execution. Calls without a valid receipt or with replayed nonces are rejected with `402 Payment Required`. Verified receipts are securely forwarded to the ContextWise Cloud backend.
+
 ---
 
 ## Server Management & Marketplace CLI