@truecarry/mcp 0.1.0 → 0.1.2

package/README.md

@@ -7,14 +7,20 @@ A Model Context Protocol (MCP) server for TON blockchain wallet operations. Buil
 - **Wallet Management**: Create, import, list, and remove TON wallets
 - **Balance Queries**: Check TON and Jetton balances
 - **Transfers**: Send TON and Jettons to any address
-- **Secure Storage**: Wallets stored locally with encryption-ready design
+- **Swaps**: Get quotes and execute token swaps
+- **Dual Transport**: Stdio (default) and HTTP server modes
 
-## Installation
+## Quick Start
 
 ```bash
-# In the monorepo
-pnpm install
-pnpm --filter @ton/mcp build
+# Run as stdio MCP server
+npx @ton/mcp
+
+# Run as HTTP server (port 3000)
+npx @ton/mcp --http
+
+# Run as HTTP server on custom port
+npx @ton/mcp --http 8080
 ```
 
 ## Usage with MCP Clients
@@ -27,13 +33,28 @@ Add to your MCP configuration:
 {
   "mcpServers": {
     "ton": {
-      "command": "node",
-      "args": ["/path/to/kit/apps/mcp/dist/index.js"]
+      "command": "npx",
+      "args": ["@ton/mcp"]
     }
   }
 }
 ```
 
+### HTTP mode
+
+Start the server and point your MCP client to the endpoint:
+
+```bash
+npx @ton/mcp --http 3000
+# MCP endpoint: http://localhost:3000/mcp
+```
+
+## Environment Variables
+
+| Variable  | Default   | Description                  |
+|-----------|-----------|------------------------------|
+| `NETWORK` | `mainnet` | TON network (`mainnet` / `testnet`) |
+
 ## Available Tools
 
 ### Wallet Management
@@ -108,34 +129,47 @@ Send Jettons to an address.
 - `amount` (required): Amount in raw units (apply decimals yourself)
 - `comment` (optional): Transaction comment/memo
 
-## Storage
-
-Wallet data is stored in `~/.ton-mcp/wallets.json`.
+### Swaps
 
-**Current Implementation:** Plaintext JSON storage
+#### `get_swap_quote`
+Get a quote for a token swap.
 
-**Security Note:** Mnemonics are currently stored in plaintext. The storage interface is designed to easily support encrypted storage in the future. Do not use this for production wallets with significant funds until encryption is implemented.
+#### `execute_swap`
+Execute a token swap.
 
 ## Development
 
 ```bash
-# Build
-pnpm build
+# Run from source (stdio)
+pnpm --filter @ton/mcp dev:cli
 
-# Watch mode
-pnpm dev
+# Run from source (HTTP)
+pnpm --filter @ton/mcp dev:cli:http
 
-# Run directly
-pnpm start
-```
+# Build
+pnpm --filter @ton/mcp build
 
-## Network
+# Run built version
+node packages/mcp/dist/cli.js
+node packages/mcp/dist/cli.js --http 8080
+```
 
-The server uses TON Mainnet by default. This can be configured in the WalletService constructor.
+## Library Usage
 
-## License
+The package also exports a programmatic API for building custom MCP servers:
 
-MIT
+```typescript
+import { createTonWalletMCP, InMemoryStorageAdapter, LocalSignerAdapter, StaticUserContextProvider } from '@ton/mcp';
 
+const server = createTonWalletMCP({
+  storage: new InMemoryStorageAdapter(),
+  signer: new LocalSignerAdapter(),
+  userContext: new StaticUserContextProvider('my-user'),
+  network: 'mainnet',
+  requireConfirmation: false,
+});
+```
 
+## License
 
+MIT

package/dist/cli.d.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 /**
  * Copyright (c) TonTech.
  *

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG"}

package/dist/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+#!/usr/bin/env node
 import { createRequire } from "node:module";
 import { createServer } from "node:http";
 import { randomFillSync, randomUUID } from "node:crypto";

package/package.json

@@ -1,15 +1,13 @@
 {
   "name": "@truecarry/mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "TON MCP Server - Model Context Protocol server for TON blockchain wallet operations",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "bin": {
-    "ton-mcp": "./dist/cli.js"
-  },
+  "bin": "./dist/cli.js",
   "exports": {
     ".": {
       "import": {