@stellar-agent/mcp-server 0.4.1 → 0.4.3
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 +18 -0
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -4,6 +4,14 @@ MCP stdio server for `stellar-agent`.
|
|
|
4
4
|
|
|
5
5
|
The server exposes agent-safe tools for the existing CLI workflows instead of duplicating payment logic. Tools include Testnet init/doctor/Friendbot funding, issued-asset and contract-asset smoke scenarios, wallet creation and balances, trustline add/remove, fee-aware payment quote/send, guarded Testnet batch payments, local x402 and MPP HTTP payments, claimable balance create/list/claim, core Stellar liquidity-pool list/inspect/trade/position/preflight/listener workflows, strategy liquidity investigation, and Stellar CLI-backed contract operations including asset deploy, info, read, fetch, invoke, upload, deploy, extend, and restore.
|
|
6
6
|
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @stellar-agent/mcp-server
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Run
|
|
14
|
+
|
|
7
15
|
Build and run from a checkout:
|
|
8
16
|
|
|
9
17
|
```bash
|
|
@@ -14,3 +22,13 @@ STELLAR_AGENT_CLI=packages/cli/dist/index.js node packages/mcp-server/dist/serve
|
|
|
14
22
|
When installed globally, `stellar-agent-mcp` uses the `stellar-agent` binary by default. Set `STELLAR_AGENT_CLI=/path/to/stellar-agent` or `STELLAR_AGENT_CLI=/path/to/packages/cli/dist/index.js` to override it.
|
|
15
23
|
|
|
16
24
|
Every tool calls `stellar-agent --json` and returns the parsed JSON output plus the CLI exit code.
|
|
25
|
+
|
|
26
|
+
## Safety
|
|
27
|
+
|
|
28
|
+
The MCP server delegates to the CLI so policy checks, Mainnet guards, redaction, and receipt behavior stay centralized. Tools should stop on `requires_approval` unless the user explicitly approves the guarded flow.
|
|
29
|
+
|
|
30
|
+
## Links
|
|
31
|
+
|
|
32
|
+
- GitHub: https://github.com/someone-in-texas/Stellar-Agent
|
|
33
|
+
- Agent integration docs: https://github.com/someone-in-texas/Stellar-Agent/blob/main/docs/agent-integration.md
|
|
34
|
+
- Codex plugin docs: https://github.com/someone-in-texas/Stellar-Agent/blob/main/docs/codex-plugin.md
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@stellar-agent/mcp-server",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.3",
|
|
4
4
|
"description": "MCP stdio server that exposes Stellar Agent Bridge CLI workflows as agent tools.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
"bugs": {
|
|
13
13
|
"url": "https://github.com/someone-in-texas/Stellar-Agent/issues"
|
|
14
14
|
},
|
|
15
|
-
"homepage": "https://github.com/someone-in-texas/Stellar-Agent#readme",
|
|
15
|
+
"homepage": "https://github.com/someone-in-texas/Stellar-Agent/tree/main/packages/mcp-server#readme",
|
|
16
16
|
"engines": {
|
|
17
17
|
"node": ">=22"
|
|
18
18
|
},
|
|
@@ -35,7 +35,7 @@
|
|
|
35
35
|
"test": "vitest run"
|
|
36
36
|
},
|
|
37
37
|
"dependencies": {
|
|
38
|
-
"@stellar-agent/core": "0.4.
|
|
38
|
+
"@stellar-agent/core": "0.4.3"
|
|
39
39
|
},
|
|
40
40
|
"devDependencies": {
|
|
41
41
|
"@types/node": "^22.15.24"
|