npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

cornerstone-autonomous-agent

v2.1.0

Published

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

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

tonic_1tonic_1

Keywords

cornerstone-mcpdemoautonomous-agentx402mcplangchainhuggingfacepredict-tickersbacktestopen-bank-accountaptosethereumwalletevmcrypto

Readme

CornerStone MCP x402 Skill – Tools for Agents

Published as cornerstone-autonomous-agent on npm; source: 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?

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

From npm (recommended)

npm install cornerstone-autonomous-agent

Copy the package’s .env.example into your project and set X402_FACILITATOR_URL, HUGGINGFACE_API_KEY, LLM_MODEL, and wallet paths. See Config.

From source

git clone https://github.com/FinTechTonic/autonomous-agent.git && cd autonomous-agent
npm install

OpenClaw / Moltbot: See adapters/openclaw/SKILL.md or use your platform’s skill install (e.g. ClawHub).

Quick Start

Important: Another npm package is named 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.

# 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

# 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"

# 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 | |----------|-------------| | 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. Skill supports all EVM chains in lib/chains.js (Base, Ethereum, Polygon, etc.). |

Commands

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 | |---------|-------------| | 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. Devnet: APTOS_FAUCET_NETWORK=devnet npm run credit:aptos. See Canteen – Aptos x402.

MCP Tools

| 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 |

Score definitions: Reputation Score measures an agent’s ability to transact using x402. Borrower score measures real borrower behavior.

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 | |---------|-----| | 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 (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

autonomous/
├── src/
│   ├── agent/           # ReAct agent, LLM, tool wiring
│   ├── lib/
│   │   ├── mcp/          # MCP client + 402 handle/retry
│   │   ├── aptos/        # Aptos wallet, balance, signPayment
│   │   ├── evm/          # EVM wallet, signPayment (Base)
│   │   └── x402/         # Payment types, verify/settle flow
│   ├── 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
│   ├── 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 runner and tools (for agents using the skill).

Tech Stack

  • Runtime: Node.js 18+
  • 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 + 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) 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: Addresses used by the agent must be allowlisted at the onboarding flow before paid tools succeed.

Capability + adapters

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

License

GPL-2.0-only. Use of this software is also subject to the Responsible AI License (RAIL). See LICENSE.md (GPL-2) and RAIL.