CreditNexus x402 Agent Skill
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).
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:
# 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:
- •
MCP_SERVER_URL– MCP server base URL (MCP protocol at/mcp) - •
X402_FACILITATOR_URL– x402 facilitator (verify/settle) - •
LLM_BASE_URL,HUGGINGFACE_API_KEYorHF_TOKEN,LLM_MODEL– for inference - •
APTOS_WALLET_PATH,EVM_WALLET_PATH(orEVM_PRIVATE_KEY) – for payments
Run the agent
From the repository root (where package.json and src/ live):
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 "..."
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:aptosornpx cornerstone-agent-attest-aptos— output to POST /attest/aptos - •EVM:
npm run attest:evmornpx 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 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.