@manifest-network/manifest-mcp-node 0.8.0 → 0.9.0

package/README.md

@@ -3,9 +3,9 @@
 Node.js CLI entry points for the Manifest MCP servers with stdio transport and encrypted keyfile wallet.
 
 Provides four binaries:
-- **`manifest-mcp-chain`** -- Chain MCP server (5 tools: queries, transactions, module discovery)
-- **`manifest-mcp-lease`** -- Lease MCP server (6 tools: credit balance, funding, lease queries, SKUs, providers)
-- **`manifest-mcp-fred`** -- Fred MCP server (8 tools: catalog, deployment, status, logs, restart, update, diagnostics, releases)
+- **`manifest-mcp-chain`** -- Chain MCP server (6 tools, +1 optional `request_faucet`: queries, transactions, fee estimation, module discovery)
+- **`manifest-mcp-lease`** -- Lease MCP server (8 tools: credit balance, funding, lease queries, custom-domain claim/lookup, SKUs, providers)
+- **`manifest-mcp-fred`** -- Fred MCP server (11 tools, plus 3 resources & 3 prompts: catalog, deployment readiness, manifest preview, deployment, ready polling, status, logs, restart, update, diagnostics, releases)
 - **`manifest-mcp-cosmwasm`** -- CosmWasm MCP server (2 tools: MFX-to-PWR rate query, token conversion)
 
 ## Setup
@@ -167,17 +167,19 @@ Set `COSMOS_RPC_URL` + `COSMOS_GAS_PRICE` for full access (queries + transaction
 
 `COSMOS_CHAIN_ID` and at least one endpoint URL are only required when starting an MCP server, not for `keygen` or `import`.
 
-## Chain server tools (5)
+## Chain server tools (6, +1 optional)
 
 | Tool | Description |
 |------|-------------|
 | `get_account_info` | Get account address for the configured key |
 | `cosmos_query` | Execute any Cosmos SDK query command |
 | `cosmos_tx` | Execute any Cosmos SDK transaction |
+| `cosmos_estimate_fee` | Estimate gas + fee for a transaction without broadcasting |
 | `list_modules` | List all available query and transaction modules |
 | `list_module_subcommands` | List available subcommands for a specific module |
+| `request_faucet` | Request tokens from a faucet (registered only when `MANIFEST_FAUCET_URL` is set) |
 
-## Lease server tools (6)
+## Lease server tools (8)
 
 | Tool | Description |
 |------|-------------|
@@ -185,15 +187,20 @@ Set `COSMOS_RPC_URL` + `COSMOS_GAS_PRICE` for full access (queries + transaction
 | `fund_credit` | Send tokens to a billing credit account (defaults to the sender; accepts `tenant`) |
 | `leases_by_tenant` | List leases by state (defaults to the caller; accepts `tenant`) |
 | `close_lease` | Close a lease on-chain |
+| `set_item_custom_domain` | Claim or release a custom domain on a lease item |
+| `lease_by_custom_domain` | Look up the lease that owns a custom domain |
 | `get_skus` | List available SKUs |
 | `get_providers` | List available providers |
 
-## Fred server tools (8)
+## Fred server tools (11)
 
 | Tool | Description |
 |------|-------------|
 | `browse_catalog` | Browse available providers and service tiers with health checks |
-| `deploy_app` | Deploy a new application (create lease + deploy container) |
+| `check_deployment_readiness` | Pre-flight checks (balance, SKU availability, image pull) before `deploy_app` |
+| `build_manifest_preview` | Preview the SDL/manifest that `deploy_app` would submit |
+| `deploy_app` | Deploy a new application (create lease + deploy container, optional custom domain) |
+| `wait_for_app_ready` | Poll provider until a deployed app reports ready |
 | `app_status` | Get detailed status for a deployed app by lease UUID |
 | `get_logs` | Get logs for a deployed app by lease UUID |
 | `restart_app` | Restart a deployed app via the provider |
@@ -201,6 +208,8 @@ Set `COSMOS_RPC_URL` + `COSMOS_GAS_PRICE` for full access (queries + transaction
 | `app_diagnostics` | Get provision diagnostics for a deployed app |
 | `app_releases` | Get release/version history for a deployed app |
 
+The Fred server also exposes 3 MCP resources (`manifest://leases/active`, `manifest://leases/recent`, `manifest://providers`) and 3 prompts (`deploy-containerized-app`, `diagnose-failing-app`, `shutdown-all-leases`).
+
 ## CosmWasm server tools (2)
 
 | Tool | Description |
@@ -208,6 +217,17 @@ Set `COSMOS_RPC_URL` + `COSMOS_GAS_PRICE` for full access (queries + transaction
 | `get_mfx_to_pwr_rate` | Get the current MFX-to-PWR conversion rate and preview amounts |
 | `convert_mfx_to_pwr` | Convert MFX tokens to PWR via the on-chain converter contract |
 
+## See also
+
+The links below resolve from the GitHub repo. They use absolute URLs because the published npm package only ships `dist/` and the `docs/` tree isn't included, so relative paths would 404 on npmjs.com.
+
+- [Tool selection guide](https://github.com/manifest-network/manifest-mcp-mono/blob/main/docs/tool-selection-guide.md) — which server to wire up and which tool to call
+- [Usage examples](https://github.com/manifest-network/manifest-mcp-mono/blob/main/docs/usage-examples.md) — end-to-end transcripts (balances, deploys, diagnostics, conversions)
+- [Prompts and resources](https://github.com/manifest-network/manifest-mcp-mono/blob/main/docs/prompts-and-resources.md) — what the Fred server's 3 prompts and 3 resources expose
+- [Troubleshooting](https://github.com/manifest-network/manifest-mcp-mono/blob/main/docs/troubleshooting.md) — error codes, common failure modes, and how to recover
+- [Security model](https://github.com/manifest-network/manifest-mcp-mono/blob/main/docs/security.md) — wallet handling, ADR-036 auth, output redaction, trust boundaries
+- [Library usage](https://github.com/manifest-network/manifest-mcp-mono/blob/main/docs/library-usage.md) — using the packages outside an MCP host
+
 ## License
 
 MIT

package/dist/chain.js

@@ -1,8 +1,18 @@
 #!/usr/bin/env node
 import { bootstrap } from "./bootstrap.js";
+import { validateEndpointUrl } from "@manifest-network/manifest-mcp-core";
 import { ChainMCPServer } from "@manifest-network/manifest-mcp-chain";
 //#region src/chain.ts
-const faucetUrl = process.env.MANIFEST_FAUCET_URL?.trim() || void 0;
+const rawFaucetUrl = process.env.MANIFEST_FAUCET_URL?.trim() || void 0;
+let faucetUrl;
+if (rawFaucetUrl) {
+	const check = validateEndpointUrl(rawFaucetUrl, "MANIFEST_FAUCET_URL");
+	if (!check.valid) {
+		console.error(`Invalid MANIFEST_FAUCET_URL: ${check.reason}`);
+		process.exit(1);
+	}
+	faucetUrl = rawFaucetUrl;
+}
 bootstrap({
 	cliName: "manifest-mcp-chain",
 	label: "chain",

package/dist/chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"chain.js","names":[],"sources":["../src/chain.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { ChainMCPServer } from '@manifest-network/manifest-mcp-chain';\nimport { bootstrap } from './bootstrap.js';\n\nconst faucetUrl = process.env.MANIFEST_FAUCET_URL?.trim() || undefined;\n\nbootstrap({\n  cliName: 'manifest-mcp-chain',\n  label: 'chain',\n  createServer: (opts) =>\n    new ChainMCPServer({\n      ...opts,\n      faucetUrl,\n    }).getServer(),\n});\n"],"mappings":";;;;AAIA,MAAM,YAAY,QAAQ,IAAI,qBAAqB,MAAM,IAAI,KAAA;AAE7D,UAAU;CACR,SAAS;CACT,OAAO;CACP,eAAe,SACb,IAAI,eAAe;EACjB,GAAG;EACH;EACD,CAAC,CAAC,WAAW;CACjB,CAAC"}
+{"version":3,"file":"chain.js","names":[],"sources":["../src/chain.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { ChainMCPServer } from '@manifest-network/manifest-mcp-chain';\nimport { validateEndpointUrl } from '@manifest-network/manifest-mcp-core';\nimport { bootstrap } from './bootstrap.js';\n\nconst rawFaucetUrl = process.env.MANIFEST_FAUCET_URL?.trim() || undefined;\nlet faucetUrl: string | undefined;\nif (rawFaucetUrl) {\n  const check = validateEndpointUrl(rawFaucetUrl, 'MANIFEST_FAUCET_URL');\n  if (!check.valid) {\n    console.error(`Invalid MANIFEST_FAUCET_URL: ${check.reason}`);\n    process.exit(1);\n  }\n  faucetUrl = rawFaucetUrl;\n}\n\nbootstrap({\n  cliName: 'manifest-mcp-chain',\n  label: 'chain',\n  createServer: (opts) =>\n    new ChainMCPServer({\n      ...opts,\n      faucetUrl,\n    }).getServer(),\n});\n"],"mappings":";;;;;AAKA,MAAM,eAAe,QAAQ,IAAI,qBAAqB,MAAM,IAAI,KAAA;AAChE,IAAI;AACJ,IAAI,cAAc;CAChB,MAAM,QAAQ,oBAAoB,cAAc,sBAAsB;AACtE,KAAI,CAAC,MAAM,OAAO;AAChB,UAAQ,MAAM,gCAAgC,MAAM,SAAS;AAC7D,UAAQ,KAAK,EAAE;;AAEjB,aAAY;;AAGd,UAAU;CACR,SAAS;CACT,OAAO;CACP,eAAe,SACb,IAAI,eAAe;EACjB,GAAG;EACH;EACD,CAAC,CAAC,WAAW;CACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manifest-network/manifest-mcp-node",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Node.js MCP servers for Manifest Network with stdio transport and keyfile wallet",
   "type": "module",
   "bin": {
@@ -44,11 +44,11 @@
     "@cosmjs/amino": "0.32.4",
     "@cosmjs/encoding": "0.32.4",
     "@cosmjs/proto-signing": "0.32.4",
-    "@manifest-network/manifest-mcp-core": "^0.8.0",
-    "@manifest-network/manifest-mcp-chain": "^0.8.0",
-    "@manifest-network/manifest-mcp-lease": "^0.8.0",
-    "@manifest-network/manifest-mcp-cosmwasm": "^0.8.0",
-    "@manifest-network/manifest-mcp-fred": "^0.8.0",
+    "@manifest-network/manifest-mcp-core": "^0.9.0",
+    "@manifest-network/manifest-mcp-chain": "^0.9.0",
+    "@manifest-network/manifest-mcp-lease": "^0.9.0",
+    "@manifest-network/manifest-mcp-cosmwasm": "^0.9.0",
+    "@manifest-network/manifest-mcp-fred": "^0.9.0",
     "@modelcontextprotocol/sdk": "1.27.1",
     "dotenv": "^17.2.3"
   },