docs: remove read-only wording from user-facing copy

Author: jarrodwatts

README.md

@@ -4,7 +4,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![CI](https://github.com/Abstract-Foundation/agw-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Abstract-Foundation/agw-mcp/actions/workflows/ci.yml)
 
-Read-only MCP server for Abstract wallet, chain, and Portal API data.
+MCP server for Abstract wallet, chain, and Portal API data.
 
 ## Quick Start
 
@@ -13,7 +13,7 @@ npx -y @abstract-foundation/agw-mcp init --chain-id 2741
 npx -y @abstract-foundation/agw-mcp serve --chain-id 2741
 ```
 
-`init` opens the hosted onboarding app (`https://mcp.abs.xyz` by default), links your wallet address for local read-only context, and writes `~/.agw-mcp/session.json`.
+`init` opens the hosted onboarding app (`https://mcp.abs.xyz` by default), links your wallet address for local context, and writes `~/.agw-mcp/session.json`.
 
 ## Client Configuration
 
@@ -40,9 +40,9 @@ npx -y @abstract-foundation/agw-mcp config --npx --chain-id 2741
 | `portal_get_app` | Fetches Portal app detail (`/api/v1/app/{id}/`) |
 | `portal_list_streams` | Lists streams for a Portal app (`/api/v1/streams/{app}/`) |
 | `portal_get_user_profile` | Fetches Portal user profile (`/api/v1/user/profile/{address}/`) |
-| `abstract_rpc_call` | Calls allowlisted read-only Abstract JSON-RPC methods |
+| `abstract_rpc_call` | Calls supported Abstract JSON-RPC methods |
 
-### `abstract_rpc_call` read-only constraints
+### `abstract_rpc_call` constraints
 
 Blocked by design in v0:
 - `eth_sendRawTransaction`
@@ -81,7 +81,7 @@ npx -y @abstract-foundation/agw-mcp init --chain-id 2741 --app-url http://localh
 
 ## Security Model (v0)
 
-- **Read-only MCP surface**: no signing, transfers, swaps, deploys, or session-key actions exposed.
+- **Scoped MCP surface**: no signing, transfers, swaps, deploys, or session-key actions exposed.
 - **No delegated signer provisioning in onboarding**: local context stores wallet address + chain only.
 - **Local-only transport**: stdio MCP (no network listener).
 - **Restrictive file permissions**: storage dir `0o700`, files `0o600`.

app/src/components/SessionWizard/steps/Creating.tsx

@@ -74,7 +74,7 @@ export default function Creating({
       <Card>
         <CardHeader>
           <CardTitle>Linking Wallet</CardTitle>
-          <CardDescription>Preparing read-only wallet context for your local MCP server.</CardDescription>
+          <CardDescription>Preparing wallet context for your local MCP server.</CardDescription>
         </CardHeader>
         <CardContent>
           <p className={styles.helper}>

app/src/components/SessionWizard/steps/NotLoggedIn.tsx

@@ -25,9 +25,9 @@ export default function NotLoggedIn() {
           </div>
         </CardHeader>
         <CardContent className={styles.loginContent}>
-          <CardTitle>AGW MCP Read-Only Onboarding</CardTitle>
+          <CardTitle>AGW MCP Onboarding</CardTitle>
           <CardDescription>
-            Connect your Abstract Global Wallet to link local read-only MCP access.
+            Connect your Abstract Global Wallet to link local MCP access.
             This does not create session keys or delegated signer access.
           </CardDescription>
         </CardContent>

app/src/components/SessionWizard/steps/Success.tsx

@@ -34,7 +34,7 @@ export default function Success() {
             </p>
           ) : null}
           <p className={styles.helper}>
-            After returning to CLI, start the read-only server with <code>agw-mcp serve</code>.
+            After returning to CLI, start the server with <code>agw-mcp serve</code>.
           </p>
         </CardContent>
         <CardFooter className={styles.footer}>

src/index.ts

@@ -26,11 +26,11 @@ function resolveCliVersion(): string {
 }
 
 const program = new Command();
-program.name("agw-mcp").description("Read-only MCP server for Abstract wallet + chain data").version(resolveCliVersion());
+program.name("agw-mcp").description("MCP server for Abstract wallet + chain data").version(resolveCliVersion());
 
 program
   .command("init")
-  .description("Link a wallet for read-only local AGW MCP context")
+  .description("Link a wallet for local AGW MCP context")
   .option("--chain-id <chainId>", "EVM chain id (env: AGW_MCP_CHAIN_ID)")
   .option("--rpc-url <rpcUrl>", "RPC URL override (env: AGW_MCP_RPC_URL)")
   .option("--app-url <url>", "Hosted onboarding URL (defaults to https://mcp.abs.xyz; env: AGW_MCP_APP_URL)")
@@ -54,7 +54,7 @@ program
       storageDir: options.storageDir,
     });
     manager.setSession(session);
-    logger.info("Wallet linked for read-only MCP usage. You can now run `agw-mcp serve`.");
+    logger.info("Wallet linked. You can now run `agw-mcp serve`.");
   });
 
 program
@@ -74,7 +74,7 @@ program
 
 program
   .command("serve")
-  .description("Run the local stdio read-only MCP server")
+  .description("Run the local stdio MCP server")
   .option("--chain-id <chainId>", "EVM chain id (env: AGW_MCP_CHAIN_ID)")
   .option("--rpc-url <rpcUrl>", "RPC URL override (env: AGW_MCP_RPC_URL)")
   .option("--storage-dir <dir>", "Session storage directory")

src/integrations/abstract-rpc/client.ts

@@ -66,10 +66,10 @@ const DEFAULT_TIMEOUT_MS = 10_000;
 
 export function assertMethodAllowed(method: string): void {
   if (BLOCKED_METHODS.has(method)) {
-    throw new Error(`RPC method "${method}" is disabled in read-only mode.`);
+    throw new Error(`RPC method "${method}" is not enabled in this build.`);
   }
   if (!ALLOWED_METHODS.has(method)) {
-    throw new Error(`RPC method "${method}" is not in the v0 allowlist.`);
+    throw new Error(`RPC method "${method}" is not supported in this build.`);
   }
 }
 

src/session/manager.ts

@@ -32,7 +32,7 @@ export class SessionManager {
     }
 
     this.session = session;
-    this.logger.info(`Loaded read-only session for ${session.accountAddress}`);
+    this.logger.info(`Loaded linked wallet session for ${session.accountAddress}`);
   }
 
   getSession(): AgwSessionData | null {

src/tools/abstract-rpc-call.ts

@@ -5,7 +5,7 @@ import type { ToolHandler } from "./types.js";
 export const abstractRpcCallTool: ToolHandler = {
   name: "abstract_rpc_call",
   description:
-    "Call an allowlisted Abstract JSON-RPC method in strict read-only mode (no sendRawTransaction/debug/pubsub/filter lifecycle).",
+    "Call supported Abstract JSON-RPC methods in this build (no sendRawTransaction/debug/pubsub/filter lifecycle).",
   inputSchema: {
     type: "object",
     properties: {

test/abstract-rpc-call.test.ts

@@ -40,7 +40,7 @@ describe("abstract_rpc_call tool", () => {
     const tool = getTool("abstract_rpc_call");
 
     await expect(tool?.handler({ method: "eth_sendRawTransaction", params: [] }, buildContext())).rejects.toThrow(
-      "disabled in read-only mode",
+      "not enabled in this build",
     );
   });
 });

test/bootstrap.test.ts

@@ -63,7 +63,7 @@ describe("bootstrap callback/session bundle flow", () => {
     expect(parsed.chainId).toBe(11124);
   });
 
-  it("materializes minimal read-only session bundle", () => {
+  it("materializes minimal session bundle", () => {
     const now = 1_800_000_000;
 
     const session = materializeSessionFromBundle(