cornerstone-autonomous-agent 1.3.0 → 2.1.0

package/README.md

@@ -1,10 +1,12 @@
-# Autonomous Agent – x402 MCP + LangChain.js
+# CornerStone MCP x402 Skill – Tools for Agents
 
-Autonomous AI agent for **x402-paid MCP tools**: predict tickers, backtest strategies, open bank accounts. Pays with **Aptos** or **EVM** via the x402 facilitator—no OpenAI key; uses **Hugging Face** for the LLM. Built for Cursor, OpenClaw/Moltbot, and headless runs.
+**Published as [cornerstone-autonomous-agent](https://www.npmjs.com/package/cornerstone-autonomous-agent)** on npm; **source: [FinTechTonic/autonomous-agent](https://github.com/FinTechTonic/autonomous-agent)**.
+
+A **skill** that gives agents a set of **x402-paid MCP tools**: predict tickers, backtest strategies, link bank accounts, and query agent/borrower scores. Agents using this skill pay with **Aptos** or **EVM** via the x402 facilitator. Designed for marketplaces where agents can autonomously download and use the skill; also usable from Cursor, OpenClaw/Moltbot, and headless runners.
 
 ## Why?
 
-Most agent demos need a full backend and separate API keys. This agent talks to an **x402 MCP server**, pays with its own Aptos and EVM wallets (verify → settle), and uses an OpenAI-compatible LLM (e.g. Hugging Face). You get **run_prediction**, **run_backtest**, **link_bank_account**, and score tools with minimal setup—whitelist your agent, fund wallets, run.
+Agents need tools, not a full backend. This skill provides **run_prediction**, **run_backtest**, **link_bank_account**, and **score tools** (get_agent_reputation_score, get_borrower_score, by-email variants). Agents using it talk to an **x402 MCP server**, pay with their own Aptos and EVM wallets (verify → settle), and get results after minimal setup—whitelist the agent’s addresses, fund wallets, then the agent can call the tools. The server offers both Aptos and EVM payment options; the skill handles 402 → pay → retry so the agent just calls the tool.
 
 ## Install
 
@@ -14,7 +16,7 @@ Most agent demos need a full backend and separate API keys. This agent talks to
 npm install cornerstone-autonomous-agent
 ```
 
-Copy the package’s `.env.example` into your project and set `MCP_SERVER_URL`, `X402_FACILITATOR_URL`, `HUGGINGFACE_API_KEY`, `LLM_MODEL`, and wallet paths. See [Config](#config).
+Copy the package’s `.env.example` into your project and set `X402_FACILITATOR_URL`, `HUGGINGFACE_API_KEY`, `LLM_MODEL`, and wallet paths. See [Config](#config).
 
 ### From source
 
@@ -23,108 +25,110 @@ git clone https://github.com/FinTechTonic/autonomous-agent.git && cd autonomous-
 npm install
 ```
 
-**OpenClaw / MoltBook / Moltbot:** Load the skill from `skills/autonomous-agent/` or [adapters/openclaw/SKILL.md](adapters/openclaw/SKILL.md). See [MoltBook / OpenClaw](#moltbook--openclaw) below. Then point `MCP_SERVER_URL` at your MCP server.
-
+**OpenClaw / Moltbot:** See [adapters/openclaw/SKILL.md](adapters/openclaw/SKILL.md) or use your platform’s skill install (e.g. ClawHub). 
 ## Quick Start
 
-From the repo root (or with the package installed):
+**Important:** Another npm package is named [autonomous](https://www.npmjs.com/package/autonomous). To run **this** package without installing, always use the full name: **`npx cornerstone-autonomous-agent`**. After you `npm install cornerstone-autonomous-agent`, the short binary `autonomous` in that project runs this CLI.
 
 ```bash
-# Generate Aptos wallet (for prediction/backtest)
-npm run setup:aptos
-
-# Generate EVM wallet (for link_bank_account)
-npm run setup
-
-# Show addresses for whitelisting at the onboarding flow (e.g. https://borrower.replit.app/flow.html)
-npm run addresses
+# Run without installing (use full package name so the other "autonomous" package isn’t used)
+npx cornerstone-autonomous-agent setup:aptos
+npx cornerstone-autonomous-agent setup
+npx cornerstone-autonomous-agent addresses
+npx cornerstone-autonomous-agent attest:aptos
+npx cornerstone-autonomous-agent "Run a 30-day prediction for AAPL"
+
+# Or install first, then you can use the short command in that project
+npm install cornerstone-autonomous-agent
+npx autonomous setup:aptos
+npx autonomous attest:aptos
 
-# (Optional) Sign wallet attestations for onboarding (POST /attest/aptos, /attest/evm)
-npx cornerstone-agent-attest-aptos
-npx cornerstone-agent-attest-evm
-# or from repo: npm run attest:aptos && npm run attest:evm
+# Or install globally for the short command everywhere
+npm i -g cornerstone-autonomous-agent
+autonomous setup:aptos
+autonomous "Run a 30-day prediction for AAPL"
 
-# Run the agent (demo: balance + AAPL prediction)
-npx cornerstone-agent "Run a 30-day prediction for AAPL"
-# or from repo: npm run agent -- "Run a 30-day prediction for AAPL"
+# From source:
+node src/setup-aptos.js
+node src/run-agent.js "Run a 30-day prediction for AAPL"
 ```
 
+**CLI:** This package registers the **`autonomous`** binary (short name) and **`cornerstone-autonomous-agent`** (matches package name). Use **`npx cornerstone-autonomous-agent <command>`** when you haven’t installed the package; use **`npx autonomous <command>`** only inside a project that has `cornerstone-autonomous-agent` installed, or **`autonomous <command>`** after a global install.
+
 ## Config
 
 Copy `.env.example` to `.env` and set:
 
 | Variable | Description |
 |----------|-------------|
-| `MCP_SERVER_URL` | x402 MCP server base URL (e.g. https://borrower.replit.app or http://localhost:4023) |
-| `X402_FACILITATOR_URL` | Facilitator base URL for Aptos (verify/settle). Use public (e.g. https://x402-navy.vercel.app/facilitator) for link_bank_account. |
-| `X402_EVM_FACILITATOR_URL` | Optional. EVM facilitator; defaults to X402_FACILITATOR_URL. Set to public when using local Aptos facilitator. |
+| `X402_FACILITATOR_URL` | Facilitator base URL (Aptos + EVM verify/settle). Use public (e.g. https://x402-navy.vercel.app/facilitator) for full demo. |
+| `X402_EVM_FACILITATOR_URL` | Optional. EVM facilitator; defaults to X402_FACILITATOR_URL. |
+| `PREFERRED_PAYMENT_ORDER` | Optional. Comma-separated `network|asset` (e.g. `aptos:2|usdc,eip155:84532|usdc`) to choose payment option when server returns multiple. |
 | `LLM_BASE_URL` | OpenAI-compatible base URL (default https://router.huggingface.co/v1) |
 | `HUGGINGFACE_API_KEY` or `HF_TOKEN` | Hugging Face API key |
 | `LLM_MODEL` | Model ID (e.g. meta-llama/Llama-3.2-3B-Instruct) |
 | `APTOS_WALLET_PATH` | Aptos wallet JSON path. Multi-wallet: ~/.aptos-agent-wallets.json. |
 | `EVM_WALLET_PATH` | EVM wallet path. Multi-wallet: ~/.evm-wallets.json. Or set EVM_PRIVATE_KEY. |
-| `BASE_SEPOLIA_RPC` | Optional; Base Sepolia RPC for link_bank_account |
+| `BASE_SEPOLIA_RPC` | Optional; Base Sepolia RPC. Skill supports all EVM chains in lib/chains.js (Base, Ethereum, Polygon, etc.). |
 
 ## Commands
 
-Prefer **npx** when the package is installed; from repo root use **npm run** or **node src/...**.
+Use **`npx cornerstone-autonomous-agent <command>`** (or, in a project that has this package installed, **`npx autonomous <command>`**). From source: `node src/<script>.js` or `npm run <script>`.
 
 | Command | Description |
 |---------|-------------|
-| `npm run setup` | Generate EVM wallet (single; for multi use agent tool `create_evm_wallet`) |
-| `npm run setup:aptos` | Generate Aptos wallet (single; for multi use `create_aptos_wallet`) |
-| `npm run addresses` | Print all Aptos and EVM addresses for whitelisting at flow.html |
-| `npm run credit:aptos` | Credit Aptos agent (devnet: programmatic; testnet: instructions) |
-| `npm run balance -- <chain>` | EVM balance (e.g. `baseSepolia`) |
-| **`npx cornerstone-agent [message]`** | Run agent (or `npm run agent -- [message]` from repo) |
-| `npm run attest:aptos` | Sign Aptos wallet attestation for onboarding POST /attest/aptos |
-| `npm run attest:evm` | Sign EVM wallet attestation for onboarding POST /attest/evm |
-| `npx cornerstone-agent-attest-aptos` | Same as attest:aptos (when package installed) |
-| `npx cornerstone-agent-attest-evm` | Same as attest:evm (when package installed) |
+| `autonomous setup` | Generate EVM wallet (single; for multi use agent tool create_evm_wallet) |
+| `autonomous setup:aptos` | Generate Aptos wallet (single; for multi use create_aptos_wallet) |
+| `autonomous setup:evm:multichain` | Generate EVM multi-chain wallet |
+| `autonomous addresses` | Print all Aptos and EVM addresses for whitelisting at https://arnstein.ch/flow.html |
+| `autonomous attest:aptos` | Sign attestation for Aptos wallet (set `APTOS_PRIVATE_KEY` or `APTOS_TESTNET_*`); submit to POST /attest/aptos |
+| `autonomous attest:evm` | Sign attestation for EVM wallet; submit to POST /attest/evm |
+| `autonomous balance [chain]` | EVM balance |
+| `autonomous transfer` | Transfer (see script for args) |
+| `autonomous contract` | Contract interaction helper |
+| `autonomous swap` | Swap helper |
+| `autonomous` or `autonomous agent` or `autonomous start [message]` | Run skill demo (default: balance + prediction) |
+| `npm run credit:aptos` | Credit Aptos wallet (devnet: programmatic; testnet: instructions) |
+| `npx cornerstone-agent [message]` | Run skill demo (legacy bin name) |
 
 **Crediting Aptos:** Testnet has no programmatic faucet—use [Aptos testnet faucet](https://aptos.dev/network/faucet). Devnet: `APTOS_FAUCET_NETWORK=devnet npm run credit:aptos`. See [Canteen – Aptos x402](https://canteenapp-aptos-x402.notion.site/).
 
 ## MCP Tools
 
-All tools are exposed at the MCP server path `/mcp`. Paid tools follow the x402 flow: call without `payment_payload` → 402 + `paymentRequirements` → sign payment → call again with `payment_payload` → facilitator verify/settle → result + `paymentReceipt`. See [MCP_INTEGRATION_REFERENCE.md](MCP_INTEGRATION_REFERENCE.md).
-
-| Tool | Resource | Description | Cost (USD) |
-|------|----------|-------------|-----------|
-| `run_prediction` | `/mcp/prediction/{symbol}` | Stock prediction (symbol, horizon) | ~0.06 (Aptos/EVM) |
-| `run_backtest` | `/mcp/backtest/{symbol}` | Backtest trading strategy (symbol, start/end, strategy) | ~0.06 |
-| `link_bank_account` | `/mcp/banking/link` | CornerStone/Plaid bank link token | ~0.05 (configurable) |
-| `get_agent_reputation_score` | `/mcp/scores/reputation` | Agent reputation (100 when allowlisted); x402 or lender credits | ~0.06 |
-| `get_borrower_score` | `/mcp/scores/borrower` | Borrower score (100 or 100+Plaid when bank linked); x402 or lender credits | ~0.06 |
-| `get_agent_reputation_score_by_email` | `/mcp/scores/reputation-by-email` | Reputation by email (requires `SCORE_BY_EMAIL_ENABLED=1`) | base + extra |
-| `get_borrower_score_by_email` | `/mcp/scores/borrower-by-email` | Borrower score by email (requires `SCORE_BY_EMAIL_ENABLED=1`) | base + extra |
+| Tool | Description | Payment |
+|------|-------------|---------|
+| `run_prediction` | Stock prediction (symbol, horizon) | x402: Aptos or EVM |
+| `run_backtest` | Backtest trading strategy | x402: Aptos or EVM |
+| `link_bank_account` | CornerStone bank link (Plaid) | x402: Aptos or EVM |
+| `get_agent_reputation_score` | Reputation Score: measures the agent's ability to transact using x402 | x402 or lender credits |
+| `get_borrower_score` | Borrower score: measures real borrower behavior | x402 or lender credits |
+| `get_agent_reputation_score_by_email` | Reputation score by email (resolves to agent) | x402 or lender credits |
+| `get_borrower_score_by_email` | Borrower score by email | x402 or lender credits |
 
-## Wallet attestation (signing)
+**Score definitions:** Reputation Score measures an agent’s ability to transact using x402. Borrower score measures real borrower behavior.
 
-To prove ownership of agent wallets during onboarding, use the **attestation** scripts. They sign an off-chain message; submit the JSON output to the onboarding server (`POST /attest/aptos`, `POST /attest/evm`).
-
-- **Aptos:** `npm run attest:aptos` or `npx cornerstone-agent-attest-aptos` — outputs `address`, `message`, `signature` (hex), `public_key_hex`.
-- **EVM:** `npm run attest:evm` or `npx cornerstone-agent-attest-evm` — outputs `address`, `message`, `signature`.
-
-Options: `--address 0x...` to attest a specific address, `--message "Custom message"` for a custom payload.
+All paid tools accept **both Aptos and EVM**; the server returns 402 with multiple options. Use `PREFERRED_PAYMENT_ORDER` to prefer one chain/asset.
 
 ## Supported Networks
 
-| Network | Use | Cost |
-|---------|-----|------|
-| Aptos testnet | run_prediction, run_backtest | ~6¢ USDC |
-| Base Sepolia | link_bank_account (testnet) | ~$3.65 |
-| Base (mainnet) | link_bank_account (production) | ~$3.65 |
+| Network | Use |
+|---------|-----|
+| Aptos testnet (aptos:2) / mainnet (aptos:1) | run_prediction, run_backtest, score tools |
+| Base Sepolia (eip155:84532), Base (eip155:8453), Ethereum, Polygon, Arbitrum, Optimism | link_bank_account, score tools (when server offers them) |
 
 ## x402 Flow
 
 ```
-Agent calls MCP tool (no payment_payload)
-  → Server returns 402 + paymentRequirements (network, amount, asset, payTo, ...)
-  → Agent signs payment, calls facilitator /verify then /settle
-  → Agent retries tool call with payment_payload
-  → Server returns result + paymentReceipt
+Agent (using this skill) calls MCP tool
+  → Server returns 402 + payment requirements (single or array of options: USDC, APT, native ETH)
+  → Skill picks one option (by preferredPaymentOrder or first), builds payload (Aptos or EVM)
+  → Skill calls facilitator /verify then /settle
+  → Skill retries request with payment_payload
+  → Server returns result + payment_receipt
 ```
 
+**Multi-asset:** The server may return multiple `paymentRequirements` (e.g. USDC on Aptos, USDC on EVM, APT on Aptos, native ETH on EVM). The client uses `preferredPaymentOrder` (e.g. `["aptos:2|usdc", "eip155:84532|native"]`) to choose, or the first option. Native ETH: client submits the ETH transfer, then sends the `txHash` in the payload; facilitator verifies on-chain.
+
 ## Architecture
 
 ```
@@ -136,84 +140,55 @@ autonomous/
 │   │   ├── aptos/        # Aptos wallet, balance, signPayment
 │   │   ├── evm/          # EVM wallet, signPayment (Base)
 │   │   └── x402/         # Payment types, verify/settle flow
-│   ├── run-agent.js      # Entrypoint (npx cornerstone-agent)
+│   ├── cli.js            # CLI router (autonomous / cornerstone-autonomous-agent)
+│   ├── run-agent.js      # Skill demo entrypoint (agent + tools)
 │   ├── setup.js          # EVM wallet generation
 │   ├── setup-aptos.js    # Aptos wallet generation
-│   ├── show-agent-addresses.js
-│   ├── attest-aptos-wallet.js  # Sign attestation for POST /attest/aptos
-│   └── attest-evm-wallet.js    # Sign attestation for POST /attest/evm
-├── skills/               # MoltBook/OpenClaw (AgentSkills layout)
-│   └── autonomous-agent/
-│       └── SKILL.md
+│   ├── attest-aptos-wallet.js / attest-evm-wallet.js
+│   └── show-agent-addresses.js
 ├── adapters/             # OpenClaw, OpenAI, Anthropic, local
 ├── .env.example
 └── package.json
 ```
 
-**Core pieces:** `lib/mcp` — MCP client and 402 retry; `lib/aptos` / `lib/evm` — wallets and payment signing; `lib/x402` — verify/settle; `agent/` — LangChain.js ReAct agent and tools.
+**Core pieces:** `lib/mcp` — MCP client and 402 retry; `lib/aptos` / `lib/evm` — wallets and payment signing; `lib/x402` — verify/settle; `agent/` — LangChain.js ReAct runner and tools (for agents using the skill).
 
 ## Tech Stack
 
 - **Runtime:** Node.js 18+
-- **Agent:** LangChain.js (ReAct), OpenAI-compatible LLM (e.g. Hugging Face)
+- **Runner:** LangChain.js (ReAct), OpenAI-compatible LLM (e.g. Hugging Face) for the demo; agents use the tools via their own runtime
 - **MCP:** [Model Context Protocol](https://modelcontextprotocol.io) + x402 payment flow
 - **Chains:** Aptos (viem-style + @aptos-labs/ts-sdk), EVM (viem) for Base Sepolia/Base
 - **Payments:** x402 facilitator (verify/settle), local wallet storage
 
 ## Security
 
-- **Wallets:** Stored locally (e.g. `~/.aptos-agent-wallets.json`, `~/.evm-wallets.json`); private keys not logged or sent except as signed payloads to the facilitator.
+- **Wallets:** Stored locally (e.g. `~/.aptos-agent-wallets.json`, `~/.evm-wallets.json`) for the agent using the skill; private keys not logged or sent except as signed payloads to the facilitator.
 - **Payments:** Only verify/settle go to the facilitator; no custody of funds by the MCP server.
-- **Whitelist:** Agent addresses must be allowlisted at the onboarding flow before paid tools succeed.
+- **Whitelist:** Addresses used by the agent must be allowlisted at the onboarding flow before paid tools succeed.
 
 ## Capability + adapters
 
-- **Capability:** Core (`src/`) — MCP client, x402 flow, local tools. No OpenAI/Claw/Anthropic logic in code.
-- **Adapters:** How each platform uses the capability:
-  - **MoltBook / OpenClaw / Moltbot:** `skills/autonomous-agent/SKILL.md` (AgentSkills-compatible; [see below](#moltbook--openclaw)) or [adapters/openclaw/SKILL.md](adapters/openclaw/SKILL.md)
-  - **OpenAI:** [adapters/openai/openapi.yaml](adapters/openai/openapi.yaml) — Custom GPTs / Assistants
-  - **Claude / Anthropic:** [adapters/anthropic/tools.json](adapters/anthropic/tools.json) — Claude tools
-  - **Local / OSS:** [adapters/local/README.md](adapters/local/README.md) — LM Studio, AutoGen, CrewAI
-
-## MoltBook / OpenClaw
-
-This repo is optimized for **easy skill loading** in MoltBook and OpenClaw (Claude, Anthropic, OpenAI, and other providers work via the same agent; the skill tells the assistant how to run it).
-
-- **Skill layout:** The skill lives in `skills/autonomous-agent/SKILL.md` (AgentSkills-compatible, single-line frontmatter, `metadata.openclaw` gating). OpenClaw/MoltBook loads skills from `skills/` subfolders.
-- **Load options:**
-  1. **extraDirs:** Add this repo path to `~/.openclaw/openclaw.json` under `skills.load.extraDirs`. OpenClaw will scan `skills/` and load `autonomous-agent`.
-  2. **Workspace:** Clone the repo and use it as your OpenClaw workspace; workspace skills are loaded from `<workspace>/skills`.
-  3. **Managed skills:** Copy `skills/autonomous-agent` to `~/.openclaw/skills/` for all agents on the machine.
-  4. **ClawHub:** When published, install with `clawhub install autonomous-agent` (installs into `./skills` by default).
-- **Config:** In `skills.entries["autonomous-agent"]` you can set `enabled`, `env`, or `apiKey` (maps to `primaryEnv`). Ensure `MCP_SERVER_URL`, x402 facilitator URLs, and LLM/env are set for the agent run.
-- **Run:** From the **repository root** (parent of `skills/`), run `npx cornerstone-agent "your message"` or `npm run agent -- "your message"`.
-
-Example `~/.openclaw/openclaw.json` to load this repo’s skills:
-
-```json
-{
-  "skills": {
-    "load": {
-      "extraDirs": ["/path/to/autonomous-agent"]
-    },
-    "entries": {
-      "autonomous-agent": {
-        "enabled": true,
-        "env": { "MCP_SERVER_URL": "https://borrower.replit.app" }
-      }
-    }
-  }
-}
-```
+- **Capability:** Core (`src/`) — MCP client, x402 flow, tools for agents. No OpenAI/Claw/Anthropic logic in code.
+- **Adapters:** `adapters/` — how each platform or marketplace loads the skill:
+  - [adapters/openclaw/SKILL.md](adapters/openclaw/SKILL.md) — OpenClaw / Moltbot
+  - [adapters/openai/openapi.yaml](adapters/openai/openapi.yaml) — Custom GPTs / Assistants
+  - [adapters/anthropic/tools.json](adapters/anthropic/tools.json) — Claude tools
+  - [adapters/local/README.md](adapters/local/README.md) — LM Studio, AutoGen, CrewAI
+
+## Deployment order
 
+1. **x402 facilitator** — Use public (e.g. https://x402-navy.vercel.app/facilitator) for full demo; or run local and set X402_EVM_FACILITATOR_URL to public for link_bank_account.
+2. **MCP server** — x402-enabled.
+3. **Skill runner (demo)** — `node src/run-agent.js` or PM2 (`pm2 start ecosystem.config.cjs --only agent-autonomous` from repo root).
 
 ## References
 
-- **Source:** [FinTechTonic/autonomous-agent](https://github.com/FinTechTonic/autonomous-agent)
-- **MCP integration:** [MCP_INTEGRATION_REFERENCE.md](MCP_INTEGRATION_REFERENCE.md) — endpoints, tools, resources, x402 flow, facilitator
 - [Canteen App – Aptos x402](https://canteenapp-aptos-x402.notion.site/) — wallet hydration and crediting
 - [LangChain.js MCP](https://js.langchain.com/docs/integrations/toolkits/mcp_toolbox)
 - [Hugging Face Inference – OpenAI-compatible](https://huggingface.co/docs/api-inference/en/index)
+- [evm-wallet-skill](https://github.com/surfer77/evm-wallet-skill) — self-sovereign EVM wallet pattern for agents
+
 ## License
 
-GPL-2.0-only. Use of this software is also subject to the [Responsible AI License (RAIL)](https://www.licenses.ai/). See [LICENSE.md](LICENSE.md) (GPL-2) and [RAIL](https://www.licenses.ai/).
+GPL-2.0-only. Use of this software is also subject to the [Responsible AI License (RAIL)](https://www.licenses.ai/). See [LICENSE.md](../LICENSE.md) (GPL-2) and [RAIL](https://www.licenses.ai/).

package/adapters/local/README.md

@@ -1,10 +1,10 @@
 # Local / OSS agents
 
-Use the CreditNexus x402 capability from local or OSS agents (e.g. LM Studio, AutoGen, CrewAI).
+Use the CornerStone MCP x402 capability from local or OSS agents (e.g. LM Studio, AutoGen, CrewAI).
 
 1. **Source:** [FinTechTonic/autonomous-agent](https://github.com/FinTechTonic/autonomous-agent).
 2. **Install:** `npm install` in `autonomous/`.
-3. **Config:** Set `MCP_SERVER_URL` to your MCP server (e.g. `https://borrower.replit.app` or `http://localhost:4023`). Set x402 facilitator URL and LLM/env as needed.
+3. **Config:** Set x402 facilitator URL and LLM/env as needed.
 4. **Run:** `node src/run-agent.js "your message"` or wire MCP client to your agent framework.
 5. **x402:** On 402 responses, call facilitator verify → settle, then retry the request with `PAYMENT-SIGNATURE` header.
 

package/adapters/openai/openapi.yaml

@@ -1,11 +1,11 @@
 openapi: 3.0.3
 info:
-  title: CreditNexus x402 MCP Tools
+  title: CornerStone MCP x402 Tools
   description: Payment-protected tools (run_prediction, run_backtest, open_bank_account, scores). Use x402 flow (402 → pay → retry with PAYMENT-SIGNATURE).
   version: 1.0.0
 servers:
-  - url: http://localhost:4023
-    description: MCP server (override with MCP_SERVER_URL)
+  - url: https://arnstein.ch/mcp
+    description: MCP server
 paths:
   /mcp/prediction/{symbol}:
     get:

package/adapters/openclaw/SKILL.md

@@ -1,62 +1,73 @@
 ---
 name: autonomous-agent
-description: CreditNexus x402 agent. Use when the user wants stock predictions, backtests, bank linking, or agent/borrower scores. Payment-protected MCP tools (run_prediction, run_backtest, link_bank_account, get_agent_reputation_score, get_borrower_score, and by-email variants) with x402 flow (Aptos + Base). Agent handles 402 → pay → retry autonomously. Supports wallet attestation (signing) for onboarding.
+description: CornerStone MCP x402 skill for agents. Tools for stock predictions, backtests, bank linking, and agent/borrower scores. Payment-protected MCP tools with x402 flow (Aptos + Base). Skill handles 402 → pay → retry. Wallet attestation for onboarding. For marketplaces where agents download and use skills autonomously.
 metadata: {"openclaw":{"emoji":"📈","homepage":"https://github.com/FinTechTonic/autonomous-agent","requires":{"bins":["node","npm"]},"primaryEnv":"MCP_SERVER_URL","skillKey":"autonomous-agent"},"clawdbot":{"emoji":"📈","homepage":"https://github.com/FinTechTonic/autonomous-agent","requires":{"bins":["node","npm"]}}}
 ---
 
-# CreditNexus x402 Agent Skill
+# CornerStone MCP x402 Skill (for Agents)
 
-Autonomous agent that calls x402-protected MCP tools: stock prediction, backtest, bank linking, and agent/borrower scores. Handles payment flow (402 → pay → retry with `payment_payload`) with Aptos (prediction/backtest) and Base (banking). Supports **wallet attestation** (signing) for onboarding (POST /attest/aptos, /attest/evm).
+Skill that gives **agents** tools to call x402-protected MCP endpoints: stock prediction, backtest, bank linking, and agent/borrower scores. **Payment is automatic** — the skill handles 402 → sign → verify → settle → retry transparently. Supports **wallet attestation** (signing) for onboarding (POST /attest/aptos, /attest/evm).
 
 ## Installation
 
 Clone or copy the repo. When loaded from OpenClaw/MoltBook, the skill folder is `{baseDir}`; run commands from the **repo root** (parent of `adapters/openclaw` or of `skills/autonomous-agent`).
 
 ```bash
-# From repository root
 git clone https://github.com/FinTechTonic/autonomous-agent.git && cd autonomous-agent
 npm install
 ```
 
-Set `MCP_SERVER_URL` to your MCP server (e.g. `https://borrower.replit.app`). Copy `.env.example` to `.env` and set:
+Copy `.env.example` to `.env` and set:
 
-- `MCP_SERVER_URL` – MCP server base URL (MCP protocol at `/mcp`)
 - `X402_FACILITATOR_URL` – x402 facilitator (verify/settle)
 - `LLM_BASE_URL`, `HUGGINGFACE_API_KEY` or `HF_TOKEN`, `LLM_MODEL` – for inference
 - `APTOS_WALLET_PATH`, `EVM_WALLET_PATH` (or `EVM_PRIVATE_KEY`) – for payments
 
-## Run the agent
+## Quick-start workflow
 
-From the **repository root** (where `package.json` and `src/` live):
+1. `get_wallet_addresses()` – check what wallets exist.
+2. If empty: `create_aptos_wallet()` + `create_evm_wallet()`.
+3. Fund: `credit_aptos_wallet()` + `fund_evm_wallet()`.
+4. Whitelist addresses at https://arnstein.ch/flow.html.
+5. Check balances: `balance_aptos()`, `balance_evm({ chain: "baseSepolia" })`.
+6. Call paid tools: `run_prediction`, `run_backtest`, `link_bank_account`, or score tools.
+
+## Run the skill (demo)
 
 ```bash
 npx cornerstone-agent "Run a 30-day prediction for AAPL"
-# Or interactive
 npx cornerstone-agent
-# Or from repo: npm run agent -- "..." or node src/run-agent.js "..."
+npm run agent -- "..."
+node src/run-agent.js "..."
 ```
 
-**x402 flow:** Agent calls tool without `payment_payload` → server returns 402 + `paymentRequirements` → agent signs, facilitator verify/settle → agent retries with `payment_payload` → receives result + `paymentReceipt`.
-
 ## Wallet attestation (signing)
 
-To prove wallet ownership during onboarding, run from repo root:
-
 - Aptos: `npm run attest:aptos` or `npx cornerstone-agent-attest-aptos` — output to POST /attest/aptos
 - EVM: `npm run attest:evm` or `npx cornerstone-agent-attest-evm` — output to POST /attest/evm
 
-## MCP Tools
-
-All tools are on the MCP server at `/mcp`. See repo [MCP_INTEGRATION_REFERENCE.md](https://github.com/FinTechTonic/autonomous-agent/blob/main/MCP_INTEGRATION_REFERENCE.md) for resources and pricing.
-
-| Tool | Resource | Description | Cost |
-|------|----------|-------------|------|
-| `run_prediction` | `/mcp/prediction/{symbol}` | Stock prediction (symbol, horizon) | ~6¢ |
-| `run_backtest` | `/mcp/backtest/{symbol}` | Backtest (symbol, start/end, strategy) | ~6¢ |
-| `link_bank_account` | `/mcp/banking/link` | CornerStone/Plaid bank link token | ~5¢ (config) |
-| `get_agent_reputation_score` | `/mcp/scores/reputation` | Agent reputation (100 allowlisted); x402 or lender credits | ~6¢ |
-| `get_borrower_score` | `/mcp/scores/borrower` | Borrower score (100 or 100+Plaid); x402 or lender credits | ~6¢ |
-| `get_agent_reputation_score_by_email` | `/mcp/scores/reputation-by-email` | Reputation by email; requires SCORE_BY_EMAIL_ENABLED | base + extra |
-| `get_borrower_score_by_email` | `/mcp/scores/borrower-by-email` | Borrower score by email; requires SCORE_BY_EMAIL_ENABLED | base + extra |
-
-Whitelist your agent at the onboarding flow (e.g. `MCP_SERVER_URL/flow.html`) so the server allows your wallet.
+## Tool reference
+
+### Wallet tools (local)
+| Tool | Args | Returns |
+|------|------|---------|
+| `get_wallet_addresses` | none | `{ aptos: [{ address, network }], evm: [...] }` |
+| `create_aptos_wallet` | `{ force?, network? }` | `{ success, address, network }` |
+| `create_evm_wallet` | `{ force?, network? }` | `{ success, address, network }` |
+| `credit_aptos_wallet` | `{ amount_octas? }` | devnet: funds directly; testnet: `{ faucet_url, address }` |
+| `fund_evm_wallet` | none | `{ faucet_url, address, message }` |
+| `balance_aptos` | none | `{ address, balances: { usdc, apt } }` |
+| `balance_evm` | `{ chain? }` | `{ address, chain, balance, symbol }` |
+
+### Paid MCP tools (x402 — payment automatic)
+| Tool | Args | Returns | Cost |
+|------|------|---------|------|
+| `run_prediction` | `{ symbol, horizon? }` | Forecast data | ~6¢ |
+| `run_backtest` | `{ symbol, startDate?, endDate?, strategy? }` | Performance metrics | ~6¢ |
+| `link_bank_account` | none | `{ link_token }` | ~5¢ |
+| `get_agent_reputation_score` | `{ agent_address?, payer_wallet? }` | `{ reputation_score }` | ~6¢ or credits |
+| `get_borrower_score` | `{ agent_address?, payer_wallet? }` | `{ score }` | ~6¢ or credits |
+| `get_agent_reputation_score_by_email` | `{ email, payer_wallet? }` | `{ reputation_score }` | higher |
+| `get_borrower_score_by_email` | `{ email, payer_wallet? }` | `{ score }` | higher |
+
+Whitelist the addresses the agent uses at https://arnstein.ch/flow.html so the server allows those wallets.

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "cornerstone-autonomous-agent",
-  "version": "1.3.0",
-  "description": "CornerStone Agentic Score: autonomous agent that uses an x402-enabled MCP server to predict tickers, backtest trading strategies, and open bank accounts. Handles 402 Payment Required (pay via Aptos/Ethereum facilitator and retry). LangChain.js ReAct agent with Hugging Face inference (OpenAI-compatible endpoint).",
+  "version": "2.1.0",
+  "description": "CornerStone MCP x402 skill for agents: tools to predict tickers, backtest strategies, link bank accounts, and query agent/borrower scores. Agents pay via Aptos/EVM (x402). Handles 402 → pay → retry. Publishable in marketplaces for autonomous download and use. Includes LangChain.js demo runner (Hugging Face / OpenAI-compatible).",
   "type": "module",
   "main": "src/run-agent.js",
   "bin": {
-    "cornerstone-agent": "src/run-agent.js",
-    "cornerstone-agent-attest-aptos": "src/attest-aptos-wallet.js",
-    "cornerstone-agent-attest-evm": "src/attest-evm-wallet.js"
+    "autonomous": "src/cli.js",
+    "cornerstone-autonomous-agent": "src/cli.js",
+    "cornerstone-agent": "src/run-agent.js"
   },
   "files": [
     "src",
@@ -51,7 +51,7 @@
     "@aptos-labs/ts-sdk": "^1.0.0"
   },
   "keywords": [
-    "creditnexus",
+    "cornerstone-mcp",
     "demo",
     "autonomous-agent",
     "x402",
@@ -67,7 +67,7 @@
     "evm",
     "crypto"
   ],
-  "author": "CreditNexus",
+  "author": "CornerStone MCP",
   "license": "GPL-2.0-only",
   "repository": {
     "type": "git",

package/skills/README.md

@@ -4,6 +4,6 @@ This folder follows the **AgentSkills** layout expected by MoltBook and OpenClaw
 
 | Skill | Description |
 |-------|-------------|
-| [autonomous-agent](autonomous-agent/SKILL.md) | x402 MCP agent: stock prediction, backtest, link_bank_account, agent/borrower scores (Aptos + Base). Wallet attestation (signing) for onboarding. |
+| [autonomous-agent](autonomous-agent/SKILL.md) | x402 MCP skill for agents: stock prediction, backtest, link_bank_account, agent/borrower scores (Aptos + Base). Wallet attestation for onboarding. |
 
 **Loading:** Add this repo path to `skills.load.extraDirs` in `~/.openclaw/openclaw.json` (MoltBook/OpenClaw will load `autonomous-agent` from `skills/autonomous-agent/`), or copy `autonomous-agent` into `~/.openclaw/skills/`, or use the repo as your OpenClaw workspace. See the main [README](../README.md#moltbook--openclaw).

package/skills/autonomous-agent/SKILL.md

@@ -1,62 +1,73 @@
 ---
 name: autonomous-agent
-description: CreditNexus x402 agent. Use when the user wants stock predictions, backtests, bank linking, or agent/borrower scores. Payment-protected MCP tools (run_prediction, run_backtest, link_bank_account, get_agent_reputation_score, get_borrower_score, and by-email variants) with x402 flow (Aptos + Base). Agent handles 402 → pay → retry autonomously. Supports wallet attestation (signing) for onboarding.
+description: CornerStone MCP x402 skill for agents. Tools for stock predictions, backtests, bank linking, and agent/borrower scores. Payment-protected MCP tools with x402 flow (Aptos + Base). Skill handles 402 → pay → retry. Wallet attestation for onboarding. For marketplaces where agents download and use skills autonomously.
 metadata: {"openclaw":{"emoji":"📈","homepage":"https://github.com/FinTechTonic/autonomous-agent","requires":{"bins":["node","npm"]},"primaryEnv":"MCP_SERVER_URL","skillKey":"autonomous-agent"},"clawdbot":{"emoji":"📈","homepage":"https://github.com/FinTechTonic/autonomous-agent","requires":{"bins":["node","npm"]}}}
 ---
 
-# CreditNexus x402 Agent Skill
+# CornerStone MCP x402 Skill (for Agents)
 
-Autonomous agent that calls x402-protected MCP tools: stock prediction, backtest, bank linking, and agent/borrower scores. Handles payment flow (402 → pay → retry with `payment_payload`) with Aptos (prediction/backtest) and Base (banking). Supports **wallet attestation** (signing) for onboarding (POST /attest/aptos, /attest/evm).
+Skill that gives **agents** tools to call x402-protected MCP endpoints: stock prediction, backtest, bank linking, and agent/borrower scores. **Payment is automatic** — the skill handles 402 → sign → verify → settle → retry transparently. Supports **wallet attestation** (signing) for onboarding (POST /attest/aptos, /attest/evm).
 
 ## Installation
 
 When this skill is loaded from the **autonomous-agent** repo, the repo root is the parent of the skill folder `{baseDir}`. Clone and install from the repo root:
 
 ```bash
-# From repository root (parent of {baseDir} when using this repo)
 git clone https://github.com/FinTechTonic/autonomous-agent.git && cd autonomous-agent
 npm install
 ```
 
-Set `MCP_SERVER_URL` to your MCP server (e.g. `https://borrower.replit.app`). Copy `.env.example` to `.env` and set:
+Copy `.env.example` to `.env` and set:
 
-- `MCP_SERVER_URL` – MCP server base URL (MCP protocol at `/mcp`)
-- `X402_FACILITATOR_URL` – x402 facilitator (verify/settle)
+- set `X402_FACILITATOR_URL` too
 - `LLM_BASE_URL`, `HUGGINGFACE_API_KEY` or `HF_TOKEN`, `LLM_MODEL` – for inference
 - `APTOS_WALLET_PATH`, `EVM_WALLET_PATH` (or `EVM_PRIVATE_KEY`) – for payments
 
-## Run the agent
+## Quick-start workflow
 
-From the **repository root** (where `package.json` and `src/` live):
+1. `get_wallet_addresses()` – check what wallets exist.
+2. If empty: `create_aptos_wallet()` + `create_evm_wallet()`.
+3. Fund: `credit_aptos_wallet()` + `fund_evm_wallet()`.
+4. Whitelist addresses at https://arnstein.ch/sse/flow.html.
+5. Check balances: `balance_aptos()`, `balance_evm({ chain: "baseSepolia" })`.
+6. Call paid tools: `run_prediction`, `run_backtest`, `link_bank_account`, or score tools.
+
+## Run the skill (demo)
 
 ```bash
 npx cornerstone-agent "Run a 30-day prediction for AAPL"
-# Or interactive
 npx cornerstone-agent
-# Or from repo: npm run agent -- "..." or node src/run-agent.js "..."
+npm run agent -- "..."
+node src/run-agent.js "..."
 ```
 
-**x402 flow:** Agent calls tool without `payment_payload` → server returns 402 + `paymentRequirements` → agent signs, facilitator verify/settle → agent retries with `payment_payload` → receives result + `paymentReceipt`.
-
 ## Wallet attestation (signing)
 
-To prove wallet ownership during onboarding, run from repo root:
-
 - Aptos: `npm run attest:aptos` or `npx cornerstone-agent-attest-aptos` — output to POST /attest/aptos
 - EVM: `npm run attest:evm` or `npx cornerstone-agent-attest-evm` — output to POST /attest/evm
 
-## MCP Tools
-
-All tools are on the MCP server at `/mcp`. See repo [MCP_INTEGRATION_REFERENCE.md](https://github.com/FinTechTonic/autonomous-agent/blob/main/MCP_INTEGRATION_REFERENCE.md) for resources and pricing.
-
-| Tool | Resource | Description | Cost |
-|------|----------|-------------|------|
-| `run_prediction` | `/mcp/prediction/{symbol}` | Stock prediction (symbol, horizon) | ~6¢ |
-| `run_backtest` | `/mcp/backtest/{symbol}` | Backtest (symbol, start/end, strategy) | ~6¢ |
-| `link_bank_account` | `/mcp/banking/link` | CornerStone/Plaid bank link token | ~5¢ (config) |
-| `get_agent_reputation_score` | `/mcp/scores/reputation` | Agent reputation (100 allowlisted); x402 or lender credits | ~6¢ |
-| `get_borrower_score` | `/mcp/scores/borrower` | Borrower score (100 or 100+Plaid); x402 or lender credits | ~6¢ |
-| `get_agent_reputation_score_by_email` | `/mcp/scores/reputation-by-email` | Reputation by email; requires SCORE_BY_EMAIL_ENABLED | base + extra |
-| `get_borrower_score_by_email` | `/mcp/scores/borrower-by-email` | Borrower score by email; requires SCORE_BY_EMAIL_ENABLED | base + extra |
-
-Whitelist your agent at the onboarding flow (e.g. `MCP_SERVER_URL/flow.html`) so the server allows your wallet.
+## Tool reference
+
+### Wallet tools (local)
+| Tool | Args | Returns |
+|------|------|---------|
+| `get_wallet_addresses` | none | `{ aptos: [{ address, network }], evm: [...] }` |
+| `create_aptos_wallet` | `{ force?, network? }` | `{ success, address, network }` |
+| `create_evm_wallet` | `{ force?, network? }` | `{ success, address, network }` |
+| `credit_aptos_wallet` | `{ amount_octas? }` | devnet: funds directly; testnet: `{ faucet_url, address }` |
+| `fund_evm_wallet` | none | `{ faucet_url, address, message }` |
+| `balance_aptos` | none | `{ address, balances: { usdc, apt } }` |
+| `balance_evm` | `{ chain? }` | `{ address, chain, balance, symbol }` |
+
+### Paid MCP tools (x402 — payment automatic)
+| Tool | Args | Returns | Cost |
+|------|------|---------|------|
+| `run_prediction` | `{ symbol, horizon? }` | Forecast data | ~6¢ |
+| `run_backtest` | `{ symbol, startDate?, endDate?, strategy? }` | Performance metrics | ~6¢ |
+| `link_bank_account` | none | `{ link_token }` | ~5¢ |
+| `get_agent_reputation_score` | `{ agent_address?, payer_wallet? }` | `{ reputation_score }` | ~6¢ or credits |
+| `get_borrower_score` | `{ agent_address?, payer_wallet? }` | `{ score }` | ~6¢ or credits |
+| `get_agent_reputation_score_by_email` | `{ email, payer_wallet? }` | `{ reputation_score }` | higher |
+| `get_borrower_score_by_email` | `{ email, payer_wallet? }` | `{ score }` | higher |
+
+Whitelist the addresses the agent uses at https://arnstein.ch/sse/flow.html so the server allows those wallets.