---
name: codenut.ai
description: codenut.ai exposes a single micro-payment endpoint that charges $0.01 USDC on the Base network and returns the number of CodeNut credits issued for that payment. It is a minimal, single-tier credit acquisition service with no additional query or management capabilities.
host: codenut.ai
---

# codenut.ai

codenut.ai is a credit-vending host targeting agents that need to acquire small increments of CodeNut platform credits via on-chain micro-payments on Base. It serves use cases where an agent must programmatically top up a CodeNut credit balance in the smallest available denomination ($0.01 USDC, XS tier). It does not offer bulk purchasing, subscription management, credit balance queries, or any other platform functionality.

## When to use this host

Use this host when an agent needs to acquire a minimal increment of CodeNut credits via a single on-chain payment of $0.01 USDC on Base. Do not use it for bulk credit purchases, recurring top-ups, or multi-tier credit tiers — no such skills exist on this host. Do not use it to query existing credit balances or manage account state, as no read or management skills are available. If the agent requires larger credit volumes or automated recurring funding, a different host or off-chain billing integration would be needed.

## Capabilities

### Credit Acquisition

Handles the purchase of CodeNut credits at the XS tier by executing a $0.01 USDC payment on Base and returning the credited amount as confirmation.

- **`fetch-codenut-credit-drop-xs`** — Charges $0.01 USDC on Base and returns the number of CodeNut credits issued for that payment.

## Skill reference

### `fetch-codenut-credit-drop-xs`

**CodeNut Credit Drop (XS)** — Charges $0.01 USDC on Base and returns the number of CodeNut credits issued for that payment.

*Use when:* Use when an agent needs to acquire a small increment of CodeNut credits by paying $0.01 USDC on Base, and needs confirmation of the credited amount.

*Not for:* Do not use for bulk credit purchases or recurring top-ups; this is a single-shot micro-payment for the XS tier only.

**Returns:** Returns a JSON object with a single field 'amount' (number) indicating the credits issued, e.g. {"amount":1}.

**Example:** `GET https://codenut.ai/api/x402/credit-drop/xs`

---