Add LITCOIN plugin · full protocol on Base + x402 Data Card

[tekkaadan]

Summary

Adds the LITCOIN skill plugin to skills/base-mcp/plugins/litcoin.md and registers it in the native-plugin table in SKILL.md.

LITCOIN is a decentralized AI-data protocol on Base mainnet (chainId 8453). Miners run AI workloads, earn LITCOIN rewards, stake into 4 tiers, mint LITCREDIT (a compute credit) against vault collateral, and trade research-grade datasets via a Data Card subscription.

What this plugin exposes

24 endpoints under https://api.litcoin.app/v1/mcp and /v1/data/x402:

• 5 read routes — wallet state (balances, staking, vaults, escrow, claimable, oracle), contract addresses, LITCOIN buy-venue discovery, oracle price, per-vault enrichment
• 19 prepare routes — unsigned calldata for approve-litcoin / approve-token / stake / unstake / early-unstake / upgrade-tier / add-to-stake / claim / open-vault / open-vault-v2 / mint-litcredit / repay-debt / add-collateral / withdraw-collateral / close-vault / deposit-escrow / withdraw-escrow / buy-litcoin / transfer
• 4 x402 onboard routes — agent-native Data Card subscription purchase gated by x402-express against USDC on Base, settled via the public x402.org facilitator

Every prepare route returns the standard envelope:

{
  "ok": true,
  "data": {
    "to": "0x...", "from": "0x...", "data": "0x...",
    "value": "0x0", "chainId": 8453,
    "description": "...", "meta": { "validation": { ... } }
  }
}

Ready for Base MCP send_calls.

Format

Spec follows the canonical Avantis plugin shape: front-matter, Surface routing table, Base-only rules, Response envelope, Read endpoints, Prepare endpoints, x402 buy flow, send_calls mapping, Disclaimers, Links.

Hosts to consider for the web_request allowlist

• https://api.litcoin.app (the full /v1/mcp + /v1/data/x402 surface)
• https://litcoin.app/.well-known/base-mcp/litcoin.md (self-hosted copy of this spec)

Verification (live, 2026-05-26)

• 5/5 read routes return 200 OK (or 503 for oracle/price with a documented DexScreener fallback URL)
• 19/19 prepare routes return 2xx envelopes (when on-chain prerequisites are met) or structured 4xx VALIDATION_ERROR with details
• 4/4 x402 onboard routes return HTTP 402 with valid paymentRequirements when X-PAYMENT header is missing

Contact

• Email: contact@litcoin.app
• Site: https://litcoin.app
• Token: 0x316ffb9c875f900AdCF04889E415cC86b564EBa3 (Base)

Test plan

• Read the plugin spec at skills/base-mcp/plugins/litcoin.md
• Curl GET https://api.litcoin.app/v1/mcp/addresses → returns chain + contract map
• Curl GET https://api.litcoin.app/v1/mcp/state/0xc1ae2db18ee47c97bd7b83165f3afea0d9c31f3c → returns balances + staking + vaults + claimable
• Curl POST https://api.litcoin.app/v1/data/x402/onboard/pilot with no X-PAYMENT → HTTP 402 with paymentRequirements

🤖 Generated with Claude Code

[cb-heimdall]

🟡 Heimdall Review Status

Requirement	Status	More Info
Reviews	🟡 0/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1