AI Agent skills for cpbox services. Pay-per-use APIs powered by the x402 protocol.
Security note: This repo contains documentation only — no executable code or credentials. See SECURITY.md for trust and scanner-related details.
| Skill | Description |
|---|---|
| answers | AI-grounded answers via OpenAI-compatible /chat/completions payloads (streaming/blocking, citations, research mode) |
| batch-balance | Batch query EVM address balances via Multicall3 |
| images-search | Image search (up to 200 results) |
| llm-context | Extracted web content for RAG/grounding (GET + POST) |
| local-descriptions | AI-generated POI descriptions (requires POI IDs from web-search) |
| local-pois | POI details (requires POI IDs from web-search) |
| news-search | News search (GET + POST) |
| spellcheck | Spell correction (Did you mean?) |
| suggest | Query suggestions/autocomplete |
| videos-search | Video search (GET + POST) |
| web-search | Web search (GET + POST) |
Note: the agent discovery manifest is in
AGENTS.md.
| Doc | Description |
|---|---|
| Rate Limiting & Security | Rate limits, credential protection, abuse prevention |
| SafeSearch defaults | Why news/images/videos have different defaults |
| Sandbox / Test environment | Testing without production costs |
| OpenAPI spec | Machine-readable API specification |
| Security & Trust | Scanner-friendly explanation; no hardcoded credentials |
| Contributing | How to add skills, PR/Issue templates |
All skills in this repository use the x402 payment protocol. Complete the following setup once before using any skill.
npm install @springmint/x402-paymentThe x402-payment SDK reads your wallet config (never stored in this repo). Supported sources:
| Priority | Method | Example |
|---|---|---|
| 1 | Environment variable | EVM_PRIVATE_KEY or TRON_PRIVATE_KEY |
| 2 | Project config file | ./x402-config.json |
| 3 | User config file | ~/.x402-config.json |
| 4 | mcporter config | ~/.mcporter/mcporter.json |
Environment variable (quickest):
# For EVM chains (BSC, Ethereum, Base, etc.)
export EVM_PRIVATE_KEY=<your_hex>
# For TRON
export TRON_PRIVATE_KEY=<your_hex>Config file (persistent): use keys evm_private_key, tron_private_key in x402-config.json. See x402-payment docs.
For full configuration details, see the x402-payment documentation.
npx @springmint/x402-payment --check
# [OK] EVM Wallet: 0x1234...abcdTell your AI agent:
Read skills/batch-balance/SKILL.md and query ETH balances for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
MIT