{"_id":"orcpin-mcp","_rev":"8-d802b2b13e40a04583bbf11551d8f843","name":"orcpin-mcp","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.0":{"name":"orcpin-mcp","version":"0.1.0","keywords":["mcp","x402","base","wallet","defi","aave","reliability","agents","claude","cursor"],"license":"MIT","_id":"orcpin-mcp@0.1.0","maintainers":[{"name":"npraught","email":"norman.praught@gmail.com"}],"homepage":"https://orcpin.dev","bugs":{"url":"https://github.com/npraught/crucial/issues"},"bin":{"orcpin-mcp":"server.mjs"},"dist":{"shasum":"99beb5057efd5532ccc15a6770cdd1acf447f3f7","tarball":"https://registry.npmjs.org/orcpin-mcp/-/orcpin-mcp-0.1.0.tgz","fileCount":3,"integrity":"sha512-RLjriArFsgCDomffoPB978zMz9LYcfOGnTbYIgjKhZ8SYCsCG10cbvdxLrXVa/y/vJWvoUWB8wKjv78Wl386hg==","signatures":[{"sig":"MEQCIEDnI2ZnlR+pkG/+JrUF0jQvtmmxKMruoFDkfFoKXxnQAiAPYAcx2WZ6nAq20TAjlbVYS8/6WFOja7yd+dQ+AI22xg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8972},"type":"module","engines":{"node":">=18"},"gitHead":"b485f7789c0b3fefba4ce3c954070afe52c89ea2","_npmUser":{"name":"npraught","email":"norman.praught@gmail.com"},"repository":{"url":"git+https://github.com/npraught/crucial.git","type":"git","directory":"mcp"},"_npmVersion":"11.12.1","description":"MCP server for Orcpin — block-anchored on-chain wallet & DeFi snapshots on Base, plus pre-flight x402 endpoint-reliability checks, paid via x402. Drop-in tool for Claude, Cursor, and agent runtimes.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orcpin-mcp_0.1.0_1782272751949_0.643332676173064","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"orcpin-mcp","version":"0.1.2","keywords":["mcp","x402","base","wallet","defi","aave","reliability","agents","claude","cursor"],"license":"MIT","_id":"orcpin-mcp@0.1.2","maintainers":[{"name":"npraught","email":"norman.praught@gmail.com"}],"homepage":"https://orcpin.dev","bugs":{"url":"https://github.com/npraught/crucial/issues"},"bin":{"orcpin-mcp":"server.mjs"},"dist":{"shasum":"ce466539decf9e7fee38f6f22674b7eab5e6e50d","tarball":"https://registry.npmjs.org/orcpin-mcp/-/orcpin-mcp-0.1.2.tgz","fileCount":3,"integrity":"sha512-SWr9RUtVGauZHbYdlHL+rqfmXUOV6vLRLhyz4twrKqhn/Sv52gXi0sgq01Gk57AS28uXemg8beEe+rKmXIWUVA==","signatures":[{"sig":"MEQCIAGxa+bcCqdaWQAouSZF2gSSYirednyFVMaDfS3ChRx3AiAgtzbHW8PuLCiqddoq5hNfMjpKfxrHUc8/YKPsJhPecA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11812},"type":"module","engines":{"node":">=18"},"gitHead":"dc0f37ff6f022f41f420dd16b2a95dfffc558756","_npmUser":{"name":"npraught","email":"norman.praught@gmail.com"},"repository":{"url":"git+https://github.com/npraught/crucial.git","type":"git","directory":"mcp"},"_npmVersion":"11.12.1","description":"MCP server for Orcpin — block-anchored on-chain wallet & DeFi snapshots on Base, plus pre-flight x402 endpoint-reliability checks, paid via x402. Drop-in tool for Claude, Cursor, and agent runtimes.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orcpin-mcp_0.1.2_1782937349875_0.6191492262727987","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"orcpin-mcp","version":"0.1.3","keywords":["mcp","x402","base","wallet","defi","aave","reliability","agents","claude","cursor"],"license":"MIT","_id":"orcpin-mcp@0.1.3","maintainers":[{"name":"npraught","email":"norman.praught@gmail.com"}],"homepage":"https://orcpin.dev","bin":{"orcpin-mcp":"server.mjs"},"dist":{"shasum":"02c2886c1078a015a09859776851d3ebeaa5c1d5","tarball":"https://registry.npmjs.org/orcpin-mcp/-/orcpin-mcp-0.1.3.tgz","fileCount":3,"integrity":"sha512-ERBLxUYgEgWxhIgUsE8rfvIdWUEGEqhPOXHtyPTUKQQ2RHWiiBvk+n2XmqK8plHgHq1CJOj4CtK4rBnp09u5vg==","signatures":[{"sig":"MEUCIQD7p4b6U4WbtPFNtOP96vUdX+GsFjrCHhdlm2IGtlcJNQIgDTHOjKt3e0M6CniZXaG4cnj3qq4izw2vmUVmtpQYC1o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11689},"type":"module","engines":{"node":">=18"},"gitHead":"9154bd5113923795dcc12f77909cf0b1913263ae","_npmUser":{"name":"npraught","email":"norman.praught@gmail.com"},"_npmVersion":"11.12.1","description":"MCP server for Orcpin — block-anchored on-chain wallet & DeFi snapshots on Base, plus pre-flight x402 endpoint-reliability checks, paid via x402. Drop-in tool for Claude, Cursor, and agent runtimes.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orcpin-mcp_0.1.3_1782939051536_0.5067440315684251","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"orcpin-mcp","version":"0.2.0","keywords":["mcp","x402","base","wallet","defi","aave","reliability","agents","claude","cursor"],"license":"MIT","_id":"orcpin-mcp@0.2.0","maintainers":[{"name":"npraught","email":"norman.praught@gmail.com"}],"homepage":"https://orcpin.dev","bin":{"orcpin-mcp":"server.mjs"},"dist":{"shasum":"77fa9e037f1eff6ceb07082566a6d024871842ad","tarball":"https://registry.npmjs.org/orcpin-mcp/-/orcpin-mcp-0.2.0.tgz","fileCount":3,"integrity":"sha512-pWTMhrpIg8ijunbbqJ0719Eto2zA7TXny7MS9IUy2ykqvd57h453EQ4F9G9hNIZ5g9ayVUyDjti6pYcOtFxC9w==","signatures":[{"sig":"MEYCIQDsCvz2VLhJAGyL5KU0qIvNWBdF1ifCvzX8yeoY2SoEPgIhAPZ6XiArRf6v+hKUxUqmQKOGG1vVQxX6QOmx2hArkBf8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16892},"type":"module","engines":{"node":">=18"},"gitHead":"a8fbfb98ba199040df4e01a7a5459bcbeb96e328","_npmUser":{"name":"npraught","email":"norman.praught@gmail.com"},"_npmVersion":"11.12.1","description":"MCP server for Orcpin — block-anchored on-chain wallet & DeFi snapshots on Base, plus pre-flight x402 endpoint-reliability checks, paid via x402. Drop-in tool for Claude, Cursor, and agent runtimes.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orcpin-mcp_0.2.0_1783048826598_0.009124949032153218","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"orcpin-mcp","version":"0.2.1","keywords":["mcp","x402","base","wallet","defi","aave","reliability","agents","claude","cursor"],"license":"MIT","_id":"orcpin-mcp@0.2.1","maintainers":[{"name":"npraught","email":"norman.praught@gmail.com"}],"homepage":"https://orcpin.dev","bin":{"orcpin-mcp":"server.mjs"},"dist":{"shasum":"f34ace2bf7d14891dcda163cf182517aefa62e81","tarball":"https://registry.npmjs.org/orcpin-mcp/-/orcpin-mcp-0.2.1.tgz","fileCount":3,"integrity":"sha512-A4xtagjL9RcapnA8vQT/EveL7f5gpWy1hJE2oogj5zt8HFKJ5mmZ8JtigYLq5Bl9Ma5tng8ZPx2y488N4Rs5BQ==","signatures":[{"sig":"MEUCIAW+c/ukvAlPOdFdFJUxyePf/MI+hy/3gENxrMqC4pZjAiEA5/Q8Z3dV/2h//nDe9sE6uycsj0zkhSVnCmApZSjBB+g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18614},"type":"module","engines":{"node":">=18"},"gitHead":"0d2fd8300f6b01a04408d7d783a5e15c16b9250e","_npmUser":{"name":"npraught","email":"norman.praught@gmail.com"},"_npmVersion":"11.12.1","description":"MCP server for Orcpin — block-anchored on-chain wallet & DeFi snapshots on Base, plus pre-flight x402 endpoint-reliability checks, paid via x402. Drop-in tool for Claude, Cursor, and agent runtimes.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orcpin-mcp_0.2.1_1783055026867_0.4336041831273312","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"orcpin-mcp","version":"0.2.2","keywords":["mcp","x402","base","wallet","defi","aave","reliability","agents","claude","cursor"],"license":"MIT","_id":"orcpin-mcp@0.2.2","maintainers":[{"name":"npraught","email":"norman.praught@gmail.com"}],"homepage":"https://orcpin.dev","bin":{"orcpin-mcp":"server.mjs"},"dist":{"shasum":"ebef86030c4d3a4472bf71d27627ca2a37392821","tarball":"https://registry.npmjs.org/orcpin-mcp/-/orcpin-mcp-0.2.2.tgz","fileCount":3,"integrity":"sha512-0RHZ5g+9ncB9fUvrh8VvHfAcmq5IBfVEXQWmf7PosiHDZ2Gc3DedoWSCETVhxKMpZ634y1xdYfr3Qg3BWX050w==","signatures":[{"sig":"MEYCIQCbiN28NZ15sKZ0cFvR5Mc6ks4+SUt0IdEdNMbhZO+iuQIhAMk0t9SXvVImfdaiU417N0Tbabo6enURJpTAJwtfcQSN","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18656},"type":"module","engines":{"node":">=18"},"gitHead":"c27c031fefb0ee3eea7768c1ab60f47cb2d26421","mcpName":"io.github.npraught/orcpin","_npmUser":{"name":"npraught","email":"norman.praught@gmail.com"},"_npmVersion":"11.12.1","description":"MCP server for Orcpin — block-anchored on-chain wallet & DeFi snapshots on Base, plus pre-flight x402 endpoint-reliability checks, paid via x402. Drop-in tool for Claude, Cursor, and agent runtimes.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orcpin-mcp_0.2.2_1783121127827_0.10531838763401735","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"orcpin-mcp","version":"0.3.0","keywords":["mcp","x402","base","wallet","defi","aave","reliability","agents","claude","cursor"],"license":"MIT","_id":"orcpin-mcp@0.3.0","maintainers":[{"name":"npraught","email":"norman.praught@gmail.com"}],"homepage":"https://orcpin.dev","bin":{"orcpin-mcp":"server.mjs"},"dist":{"shasum":"d8e07bb4aed159cd076eee3ed6e3379f38709fde","tarball":"https://registry.npmjs.org/orcpin-mcp/-/orcpin-mcp-0.3.0.tgz","fileCount":3,"integrity":"sha512-TKJFlJnMkQZOsVqqP2stQxaVV19lMfZrrr2FPfjV0spiAb6xt0Q1XevdWbQDW2nr7FHylTHelAOiAtrXpur72g==","signatures":[{"sig":"MEYCIQCB6FuMAfYFYmBj1ZULKxXI2fCHhvJnwZEZHgavePCXdAIhAL6flgdAlhQbtEYSQj0NBOGEVgrnlnrYi6jBh3/qYsy3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22137},"type":"module","engines":{"node":">=18"},"gitHead":"4d14e03f374975ba6599206db011db197fe1616b","mcpName":"io.github.npraught/orcpin","_npmUser":{"name":"npraught","email":"norman.praught@gmail.com"},"_npmVersion":"11.12.1","description":"MCP server for Orcpin — block-anchored on-chain wallet & DeFi snapshots on Base, plus pre-flight x402 endpoint-reliability checks, paid via x402. Drop-in tool for Claude, Cursor, and agent runtimes.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","viem":"^2.52.2","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/orcpin-mcp_0.3.0_1784671122494_0.6649716105082182","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"orcpin-mcp","version":"0.3.1","description":"MCP server for Orcpin — block-anchored on-chain wallet & DeFi snapshots on Base, plus pre-flight x402 endpoint-reliability checks, paid via x402. Drop-in tool for Claude, Cursor, and agent runtimes.","type":"module","bin":{"orcpin-mcp":"server.mjs"},"engines":{"node":">=18"},"homepage":"https://orcpin.dev","keywords":["mcp","x402","base","wallet","defi","aave","reliability","agents","claude","cursor"],"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","@x402/evm":"^2.15.0","@x402/fetch":"^2.15.0","viem":"^2.52.2","zod":"^3.23.8"},"mcpName":"io.github.npraught/orcpin","gitHead":"d8cbaf32044ac5a677dc6f8b134086e40840530f","_id":"orcpin-mcp@0.3.1","_nodeVersion":"26.0.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-QM7128GYXnIFrQgISeXJ0KIN/6rHoHpOqdqag1SHgmIfP+rtJYPC0x3vr6v9KnwydM1X7o+t/KDfU8nlAbisBw==","shasum":"6386855b12547898811aa0fa759f653426b60c40","tarball":"https://registry.npmjs.org/orcpin-mcp/-/orcpin-mcp-0.3.1.tgz","fileCount":3,"unpackedSize":24040,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDJSWQ/SZSCOdX8G6hSkEyZZ2ueVcfjCc8766aMs8G/kAIgQioQsrokvk5CWEawHr3zeJvKE/n0J0vbg97QF6PKMXA="}]},"_npmUser":{"name":"npraught","email":"norman.praught@gmail.com"},"directories":{},"maintainers":[{"name":"npraught","email":"norman.praught@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/orcpin-mcp_0.3.1_1786130400664_0.6375093127275904"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-24T03:45:51.738Z","modified":"2026-08-07T19:20:00.978Z","0.1.0":"2026-06-24T03:45:52.114Z","0.1.2":"2026-07-01T20:22:30.009Z","0.1.3":"2026-07-01T20:50:51.669Z","0.2.0":"2026-07-03T03:20:26.749Z","0.2.1":"2026-07-03T05:03:46.993Z","0.2.2":"2026-07-03T23:25:27.949Z","0.3.0":"2026-07-21T21:58:42.623Z","0.3.1":"2026-08-07T19:20:00.828Z"},"license":"MIT","homepage":"https://orcpin.dev","keywords":["mcp","x402","base","wallet","defi","aave","reliability","agents","claude","cursor"],"description":"MCP server for Orcpin — block-anchored on-chain wallet & DeFi snapshots on Base, plus pre-flight x402 endpoint-reliability checks, paid via x402. Drop-in tool for Claude, Cursor, and agent runtimes.","maintainers":[{"name":"npraught","email":"norman.praught@gmail.com"}],"readme":"# orcpin-mcp\n\nMCP server for [Orcpin](https://orcpin.dev) — block-anchored on-chain **wallet & DeFi snapshots on Base**, **pre-flight x402 endpoint-reliability checks**, and **deterministic trade-log calculators for trading agents** (holding periods, day-trade counts, T+1 settlement dates), paid transparently via x402 — plus a **free x402 resource directory that needs no wallet at all**. Drop it into Claude Desktop, Cursor, or any MCP-compatible agent runtime and your agent gets nine tools:\n\n| Tool | What it returns | Price |\n|---|---|---|\n| `orcpin_x402_directory` | Search the public x402 ecosystem: ~1,000 paid endpoints from the CDP Bazaar ranked by distinct paying wallets over 30 days. Filter by text, network and max price. **Works with no wallet configured.** | **Free** |\n| `orcpin_wallet_snapshot` | Native ETH + ERC-20 balances, account flags, derived metrics (wallet type, activity tier, gas runway) | $0.02 |\n| `orcpin_defi_snapshot` | Wallet snapshot + live Aave v3 collateral/debt/health factor + derived risk metrics (net equity, LTV utilization, leverage, health-factor band, drawdown tolerance) | $0.05 |\n| `orcpin_batch_snapshot` | Many addresses in one paid call, anchored to a single block (up to 1,000) | $0.02/addr · 20–40% volume off at 10/50/100 |\n| `orcpin_endpoint_reliability` | Pre-flight an x402 endpoint before paying it: reachability/uptime rate, valid-402 rate, latency p50/p95/p99, last status, sampled paid-delivery check. Facts only — no trust score. | $0.01 |\n| `orcpin_endpoint_reliability_batch` | Sweep a whole tool list of x402 endpoints in one call (up to 150) | $0.01/endpoint · 20–40% volume off at 10/50/100 |\n| `orcpin_holding_period` | Per-lot days held, the exact date each lot's gain turns long-term (IRC §1222 cited), FIFO / specific-ID sell allocation with realized gain per lot (up to 500 lots) | $0.02 |\n| `orcpin_day_trade_count` | Matched same-day buy/sell pairs in the rolling five-TRADING-day window on a versioned NYSE holiday calendar, with FINRA Rule 4210's definition quoted — never applied (up to 1,000 trades) | $0.02 |\n| `orcpin_settlement_dates` | T+1 settlement date per trade and settled/unsettled status as of any date, weekends & market holidays handled (SEC Rule 15c6-1 cited) | $0.02 |\n\n**Building a trading agent only?** Add `\"ORCPIN_TOOLSETS\": \"trading\"` to the env and the server exposes just the three calculators (`\"defi\"` gives just the five chain/reliability tools; default is all eight paid tools). `orcpin_x402_directory` is free and always exposed regardless of the toolset — it is the one tool that works before you have a funded wallet. The trading calculators are pure arithmetic on the trades you pass in — counts, dates, and dollars with the governing rule quoted in every response; nothing you send is ever stored.\n\nPayment is handled for you: the server signs a **gasless USDC authorization** (EIP-3009) with the wallet you configure. No ETH needed — only USDC.\n\n## Quick start\n\nYou need a Base wallet with a small USDC balance (a few dollars covers thousands of calls).\n\n**1. Get a funded wallet.** Use a **dedicated, low-balance wallet** (the key lives in a config file). Fund it with **USDC on Base mainnet** — buy on Coinbase and withdraw to the Base network, or bridge USDC to Base. No ETH required (settlement is gasless for you). You'll need the wallet's private key (`0x` + 64 hex).\n\n**2. Add the server to your client.**\n\n### Claude Desktop\n\nEdit `claude_desktop_config.json`\n(macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\\Claude\\`):\n\n```json\n{\n  \"mcpServers\": {\n    \"orcpin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"orcpin-mcp\"],\n      \"env\": {\n        \"ORCPIN_PRIVATE_KEY\": \"0xYOUR_FUNDED_BASE_WALLET_KEY\",\n        \"X402_NETWORK\": \"eip155:8453\"\n      }\n    }\n  }\n}\n```\n\nFully quit and reopen Claude Desktop.\n\n### Cursor\n\nAdd the same block to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project).\n\n### Claude Code\n\n```\nclaude mcp add orcpin -e ORCPIN_PRIVATE_KEY=0xYOUR_KEY -- npx -y orcpin-mcp\n```\n\n## How to use it\n\nOnce it's loaded, the agent sees the tools and calls them on its own when relevant. The directory tool works immediately; the rest need a funded wallet. You just ask in natural language:\n\n- *\"What x402 search APIs are there on Base under a cent?\"* → `orcpin_x402_directory` (free, no wallet needed)\n- *\"Use orcpin to get the DeFi snapshot for `0xabc…`\"* → `orcpin_defi_snapshot`\n- *\"What's the balance and gas runway for `0xabc…`?\"* → `orcpin_wallet_snapshot`\n- *\"Snapshot these 50 treasury addresses at one block.\"* → `orcpin_batch_snapshot`\n- *\"Before you call `https://some-api.example/v1/x`, check whether it's reliable.\"* → `orcpin_endpoint_reliability`\n- *\"Sweep these 20 endpoints for uptime and latency.\"* → `orcpin_endpoint_reliability_batch`\n- *\"When do these lots go long-term, and what's the realized gain if I sell 150 today?\"* → `orcpin_holding_period`\n- *\"How many day trades are in my last five trading days?\"* → `orcpin_day_trade_count`\n- *\"Which of yesterday's sale proceeds have settled?\"* → `orcpin_settlement_dates`\n\nYou don't touch HTTP or payment. **Per call:** the agent invokes the tool → the server hits Orcpin unpaid → gets a `402` with the price → signs a gasless USDC authorization with your wallet → the facilitator settles on Base → the server returns the block-anchored JSON. Typically ~2–4 seconds.\n\nTo confirm it's working after setup, ask the agent to *\"list your orcpin tools\"* or run any snapshot on a known address — a returned JSON snapshot means payment + delivery work.\n\n## Config\n\n| Env | Default | Notes |\n|---|---|---|\n| `ORCPIN_PRIVATE_KEY` | — | Funded buyer wallet (`0x` + 64 hex). Required — every tool here is a paid call. Orcpin's free x402 resource directory is a plain HTTP GET and needs no wallet: `https://orcpin.dev/v1/x402/discovery/resources?q=search` |\n| `ORCPIN_URL` | `https://orcpin.dev` | Override for testing. |\n| `X402_NETWORK` | `eip155:8453` | Base mainnet. |\n| `ORCPIN_TOOLSETS` | all | Comma-separated subset: `defi` (chain + reliability tools) and/or `trading` (trade-log calculators). |\n\nWithout `ORCPIN_PRIVATE_KEY` the server still starts (`payments disabled (no key)`); paid tools return a clear \"funding required\" message instead of hanging.\n\n## Security\n\n- Your private key stays local — it is read from env and used only to sign x402 payment authorizations to `orcpin.dev`. It is never logged or transmitted anywhere else.\n- Fund a **dedicated, low-balance** wallet for this; don't use a primary wallet. Rotate it if the config is ever shared.\n- Orcpin reads only public on-chain data and never stores the addresses you query (see https://orcpin.dev/privacy).\n- The trading calculators are stateless: the lots/trades in a request are computed on and never stored or logged. Formulas and conventions are published at https://orcpin.dev/methodology.\n","readmeFilename":"README.md"}