Provides instant $1-$5 USDC microloans on Base mainnet for AI agents, with fast disbursement, credit checks, and flexible repayment options.
# AgentCredit — Flash Microloans for AI Agents
## Description
AgentCredit provides instant USDC microloans ($1-$5) for AI agents on Base mainnet. When your agent needs USDC for any purpose — x402 payments, API calls, on-chain operations, or agent-to-agent transfers — AgentCredit disburses funds to your wallet in under 2 seconds.
## Security & Trust
### Credentials & Signing
This skill requires **EIP-191 wallet signatures** for write operations (register, request loan). Your agent must have access to wallet signing capabilities.
**Key points:**
- This skill does NOT store or request private keys
- Direct loan requests (REST API / MCP) require an EIP-191 signature
- In facilitator mode, credit is extended transparently during x402 settlement — no additional signature needed (the x402 payment itself is cryptographic proof)
- Read operations (check_credit, list loans) require NO signatures
### On-Chain Addresses
- **Pool wallet**: `0x510a64F194CB6196d34C93717d88f13aCF0C979f` ([BaseScan](https://basescan.org/address/0x510a64F194CB6196d34C93717d88f13aCF0C979f))
- **USDC contract**: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` ([BaseScan](https://basescan.org/address/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913))
- **Network**: Base mainnet (CAIP-2: eip155:8453)
### How Facilitator Mode Works
AgentCredit operates as an x402 facilitator. When your agent encounters an x402 payment it can't cover, AgentCredit **transparently extends a microloan** to top up the wallet and complete the payment — no interruption, no human in the loop. The agent repays from subsequent revenue.
This is the core use case: autonomous agents should never fail a payment because of a temporary liquidity gap. Built-in safeguards prevent abuse:
- Max $5 per loan, max $10 total exposure, max 3 outstanding loans
- Agents must register (one-time, with EIP-191 signature) before credit is available
- First 100 x402 settlements are free with no registration
- Overdue loans block further facilitator settlements until repaid
### Limits & Caps
| Constraint | Value |
|-----------|-------|
| Max single loan | $5 USDC |
| Max outstanding | 3 loans per wallet |
| Max total exposure | $10 per wallet |
| Pool cap | $1,000 USDC |
### Source & Links
- **Source**: [github.com/spekn-ai/agentcredit](https://github.com/spekn-ai/agentcredit)
- **API**: https://agentlending.spekn.com
- **Operator**: [Spekn](https://spekn.com)
- **Status**: MVP / experimental — use test amounts only
## Capabilities
- **Check credit**: Query available credit balance and tier for any registered wallet
- **Request loan**: Borrow $1-$5 USDC instantly, disbursed on Base in ~2 seconds
- **Repay loan**: Repay via x402, direct USDC transfer, or on-chain tx confirmation
- **x402 facilitator**: Use as your x402 facilitator URL — credit is extended transparently when your balance is short
## Integration
### As x402 Facilitator (recommended — fully autonomous)
```typescript
import { wrapFetch } from '@x402/fetch';
const fetchWith402 = wrapFetch(fetch, walletClient, {
facilitatorUrl: 'https://agentlending.spekn.com',
});
```
First 100 settlements free. Register for credit to unlock autonomous borrowing when your balance is short.
### As MCP Server
```json
{
"mcpServers": {
"agentcredit": {
"type": "streamable-http",
"url": "https://agentlending.spekn.com/mcp"
}
}
}
```
Tools: `check_credit`, `request_loan`, `repay_loan`
### As REST API
```
POST /agents/register — Register wallet (EIP-191 signature required)
GET /agents/:wallet/credit — Check credit (no auth)
GET /agents/:wallet/loans — List loans (no auth)
POST /loans/request — Request loan (EIP-191 signature required)
GET /loans/:id/pay — Repay via x402 (returns 402)
```
Full docs: https://agentlending.spekn.com/llms-full.txt
## Fee Model
Loans are designed for **fast repayment** — borrow, use, repay within hours. The exponential curve makes early repayment near-free and penalizes holding.
| Timing | $1 loan cost (BB tier) | Effective rate |
|--------|----------------------|----------------|
| 1 hour | ~$1.005 | 0.5% |
| 4 hours (target term) | ~$1.006 | 0.6% |
| 24 hours | ~$1.02 | 2% |
| 7 days (penalty zone) | ~$2.50 | 150% |
- **Origination fee**: $0.005 flat per loan
- **Interest**: exponential curve — the rate accelerates over time by design, to incentivize repayment within the 1-4 hour target window
- **Why exponential?** Flat rates would make it rational to hold loans indefinitely. The steep 7-day cost exists as a **deterrent, not a revenue model** — agents that repay promptly (as intended) pay fractions of a cent
- Higher tiers (BBB, AA+) get lower rates as a reward for good repayment history
## Authentication
Write operations require EIP-191 signatures with server-issued nonces for replay protection:
1. **Get a nonce**: `GET /auth/nonce?wallet=<addr>&action=register|request_loan` — returns a single-use nonce valid for 5 minutes
2. **Sign the message** (include the nonce):
- Register: sign `AgentCredit:register:<wallet_lowercase>:<nonce>`
- Request loan: sign `AgentCredit:request_loan:<wallet_lowercase>:<amountUsdc>:<nonce>`
3. **Send request** with `signature` and `nonce` in the body
Read operations and repayments do not require signatures.
## Discovery
- x402: https://agentlending.spekn.com/.well-known/x402.json
- A2A Agent Card: https://agentlending.spekn.com/.well-known/agent-card.json
- MCP: https://agentlending.spekn.com/mcp
- llms.txt: https://agentlending.spekn.com/llms.txt
don't have the plugin yet? install it then click "run inline in claude" again.