# AsterPay — Master Agent Skill

> Single-file install for Claude, Cursor, Codex, and any MCP-aware coding agent.
> Trust check + first EUR settlement in one curl.

**Operator:** AELIRA LTD (Cyprus, MiCA jurisdiction)
**API base:** https://x402.asterpay.io
**Site index:** https://asterpay.io/llms.txt
**Full reference:** https://asterpay.io/llms-full.txt

---

## What AsterPay does

AsterPay is the trust, discovery, and EUR settlement layer for AI agent payments.
It accepts both **x402** (Coinbase HTTP 402) and **MPP** (Stripe/Tempo Machine Payments Protocol) on every paid endpoint, and converts USDC/EURC to EUR via SEPA Instant in under 10 seconds.

Three product layers:

1. **TRUST (KYA — Know Your Agent)** — 5-layer trust score 0-100, sanctions screening (Chainalysis), ERC-8004 identity check.
2. **DISCOVERY (MPE — Merchant Payment Endpoint)** — agent passes a company name or VAT, AsterPay returns the verified IBAN/BIC plus PSD2 Verification of Payee confidence.
3. **SETTLEMENT** — USDC/EURC to EUR via SEPA Instant, MiCA-aligned via licensed partners.

---

## Install (pick one)

### MCP server (Claude Desktop, Cursor, Windsurf, Codex)

```json
{
  "mcpServers": {
    "asterpay": {
      "command": "npx",
      "args": ["@asterpay/mcp-server"]
    }
  }
}
```

18 tools, 16 free, no API key, no signup. Paid tools use x402 (USDC on Base) when invoked.

### Python SDK

```bash
pip install asterpay
```

```python
from asterpay import AsterPay

client = AsterPay()
score = client.kya.score("0xAgentWallet...")
print(f"Trust: {score['score']}/100 ({score['tier']})")
```

### TypeScript SDK

```bash
npm install @asterpay/sdk
```

### Raw HTTP

No SDK needed. Every free endpoint is `GET` and returns JSON.

---

## First call: trust check (FREE)

```bash
curl https://x402.asterpay.io/v1/agent/trust-score/0x1234567890123456789012345678901234567890
```

Returns:

```json
{
  "success": true,
  "data": {
    "address": "0x1234...",
    "score": 72,
    "tier": "verified",
    "blocked": false,
    "components": { "identity": 85, "activity": 60, "credentials": 70, "behavioral": 75 },
    "sanctions": { "clean": true, "provider": "chainalysis" }
  }
}
```

Use this **before** any x402 payment over $1 to avoid paying sanctioned or blocked counterparties.

---

## First settlement quote (FREE)

```bash
curl "https://x402.asterpay.io/v1/settlement/estimate?amount=100"
```

Returns the EUR amount, fee, exchange rate, and SEPA timing for a 100 USDC settlement.

---

## Resolve a merchant by company name (FREE)

```bash
curl "https://x402.asterpay.io/v1/mpe/merchants/resolve?business_id=FI12345678&business_id_type=vat"
```

Returns verified IBAN/BIC from up to 5 sources with a Verification of Payee (PSD2) confidence score.

---

## Tool inventory (MCP server, 18 tools)

| Category | Tools | Cost |
|----------|-------|------|
| Agent trust (KYA) | `check_agent_trust`, `verify_agent_identity`, `get_agent_tier` | Free |
| Market data | `get_crypto_price`, `get_ohlcv`, `get_trending` | Free |
| AI | `ai_summarize`, `ai_sentiment`, `ai_translate`, `ai_code_review` | Free |
| Crypto | `wallet_score`, `token_analysis`, `whale_alerts` | Free |
| Utility | `generate_qr_code`, `take_screenshot`, `generate_pdf` | Free |
| Settlement | `settlement_estimate` | Free |
| Discovery | `discover_endpoints` | Free |
| Deep analysis | `agent_deep_analysis` | $0.01 (x402) |
| Batch | `agent_trust_batch` | $0.05 (x402) |

---

## Pricing summary

- Free: KYA trust score, settlement estimate, MPE resolve, market rates, framework spec, agent card.
- Paid per call: $0.001 to $0.10 USDC depending on endpoint, paid via x402 or MPP.
- EUR settlement fee (EU rail): 0.5% + EUR 0.10 per settled txn.
- EUR settlement fee (US rail): 1.5% + EUR 1.00 per settled txn.
- No native AsterPay token. No token discounts. No subscription.

---

## Discovery URLs

- Site index: https://asterpay.io/llms.txt
- Full API reference: https://asterpay.io/llms-full.txt
- Agent card (A2A/AP2): https://asterpay.io/.well-known/agent.json
- x402 capability manifest: https://asterpay.io/.well-known/x402.json
- KYA Trust Score schema v1: https://asterpay.io/.well-known/kya-schema-v1
- ChatGPT plugin manifest: https://asterpay.io/.well-known/ai-plugin.json
- OpenAPI 3.1 spec: https://x402.asterpay.io/docs/json
- Swagger UI: https://x402.asterpay.io/docs

---

## Compliance posture

- MiCA jurisdiction. AELIRA LTD, Cyprus.
- Sanctions screening on every paid call (Chainalysis).
- Travel Rule applied above 1,000 EUR.
- EU AI Act: KYA assessed as limited-risk, Article 50 transparency on every API response.
- ERC-8004 Agent #16850 on Base mainnet.
- Listed on https://x402.org/ecosystem (Coinbase x402).
- Member of Circle Alliance.

---

## Contact

- Email: hello@asterpay.io
- X: @Asterpayment
- Discord: linked from https://asterpay.io
- Status: https://api.asterpay.io/v1/incidents/status