@elisym/mcp 0.21.1 → 0.23.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -11
- package/dist/index.js +991 -165
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -107,15 +107,17 @@ The bootstrap step is unchanged - the wizard collects the passphrase interactive
|
|
|
107
107
|
|
|
108
108
|
## Environment Variables
|
|
109
109
|
|
|
110
|
-
| Variable | Description
|
|
111
|
-
| --------------------------- |
|
|
112
|
-
| `ELISYM_AGENT` | Load agent from `~/.elisym/<name>/` (or a project-local `.elisym/<name>/`)
|
|
113
|
-
| `ELISYM_NOSTR_SECRET` | Nostr secret key (hex or nsec) for ephemeral mode
|
|
114
|
-
| `ELISYM_AGENT_NAME` | Agent display name (default: mcp-agent)
|
|
115
|
-
| `ELISYM_NETWORK` | Solana network for ephemeral
|
|
116
|
-
| `ELISYM_PASSPHRASE` | Passphrase for encrypted agent configs (optional)
|
|
117
|
-
| `ELISYM_ALLOW_WITHDRAWAL` | Set to `1` to override per-agent `security.withdrawals_enabled` flag (CI use)
|
|
118
|
-
| `ELISYM_ALLOW_AGENT_SWITCH` | Set to `1` to override per-agent `security.agent_switch_enabled` flag
|
|
110
|
+
| Variable | Description |
|
|
111
|
+
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
112
|
+
| `ELISYM_AGENT` | Load agent from `~/.elisym/<name>/` (or a project-local `.elisym/<name>/`) |
|
|
113
|
+
| `ELISYM_NOSTR_SECRET` | Nostr secret key (hex or nsec) for ephemeral mode |
|
|
114
|
+
| `ELISYM_AGENT_NAME` | Agent display name (default: mcp-agent) |
|
|
115
|
+
| `ELISYM_NETWORK` | Solana network for ephemeral/auto-created identities: `devnet` (default) or `mainnet`. It cannot override a disk-loaded agent - an agent's network is fixed at creation, and a conflicting value fails startup |
|
|
116
|
+
| `ELISYM_PASSPHRASE` | Passphrase for encrypted agent configs (optional) |
|
|
117
|
+
| `ELISYM_ALLOW_WITHDRAWAL` | Set to `1` to override per-agent `security.withdrawals_enabled` flag (CI use) |
|
|
118
|
+
| `ELISYM_ALLOW_AGENT_SWITCH` | Set to `1` to override per-agent `security.agent_switch_enabled` flag |
|
|
119
|
+
|
|
120
|
+
The RPC endpoint is always the public one for each agent's network (`api.devnet.solana.com` / `api.mainnet-beta.solana.com`). The MCP server deliberately does **not** honor `SOLANA_RPC_URL`: one process can host agents on both networks, and a process-wide override could point a devnet agent's payment path at mainnet. Creating a mainnet agent: `npx @elisym/mcp init <name> --network mainnet` (or the `create_agent` tool's `network` parameter); the network is fixed at creation, and `switch_agent` to a mainnet-bound agent is how a session changes network.
|
|
119
121
|
|
|
120
122
|
## Usage Examples
|
|
121
123
|
|
|
@@ -202,7 +204,7 @@ npx @elisym/mcp disable-agent-switch <agent>
|
|
|
202
204
|
|
|
203
205
|
The MCP process enforces a shared cap on total amount spent per asset by `submit_and_pay_job`, `buy_capability`, and `send_payment`. `withdraw` is NOT counted (uses its own gate).
|
|
204
206
|
|
|
205
|
-
Defaults (hardcoded): `0.5 SOL
|
|
207
|
+
Defaults (hardcoded): `0.5 SOL` (shared), `50 USDC` per network, and `1,000,000 LSM` (mainnet-only) (the limiter is mint-keyed, so devnet USDC and mainnet USDC each get their own cap). Native SOL has no mint, so its cap is a single entry shared across networks - deliberate: in a mixed-network process the shared draw-down can only under-allow, never over-spend.
|
|
206
208
|
|
|
207
209
|
Soft warnings fire once per process when committed spend first crosses 50% and 80% of the cap for an asset; the warning is appended to the tool result and logged at `warn` level. Crossing the cap is still a hard reject (the tool call fails).
|
|
208
210
|
|
|
@@ -210,7 +212,7 @@ Overrides live in `~/.elisym/config.yaml` and are applied at MCP start (restart
|
|
|
210
212
|
|
|
211
213
|
```bash
|
|
212
214
|
npx @elisym/mcp set-session-limit 1 # raise SOL cap to 1 per session
|
|
213
|
-
npx @elisym/mcp set-session-limit 100 --token usdc --mint <mint> #
|
|
215
|
+
npx @elisym/mcp set-session-limit 100 --token usdc --mint <mint> # per-mint USDC cap (one per network)
|
|
214
216
|
npx @elisym/mcp clear-session-limit # revert SOL to default
|
|
215
217
|
npx @elisym/mcp clear-session-limit --all # revert all assets to defaults
|
|
216
218
|
npx @elisym/mcp session-limits # list effective caps
|