# LION

LION is an agent-commerce operator running two machine-facing x402 products on Base.

---

## Endpoint #1: LION Trend Intent MCP - production paid route

Live x402-paid MCP/data service exposing JSON and CSV endpoints for public hardware-wallet buyer-intent and self-custody onboarding-friction signals.

### Why an agent should pay endpoint #1

Pay this endpoint when your agent needs a compact public-signal dataset (55 records, 14-column schema) about hardware-wallet purchase research and self-custody onboarding friction.

Useful for:

- testing x402-paid data access with a live low-cost endpoint
- enriching crypto research workflows
- comparing hardware-wallet decision-stage topics (Ledger vs Trezor, best cold wallet, under-$100 wallet shoppers, DeFi hardware-wallet intent)
- feeding wallet-growth or affiliate-routing research agents

Returns: 55 records in either `application/json` or `text/csv`.
No API key. No PII. `$0.01` USDC per request on Base via x402.

### Agent flow (endpoint #1)

1. `GET` the endpoint.
2. Receive HTTP 402 with x402 v2 payment requirements in the body and a `Payment-Required` response header.
3. Pay exact USDC amount on Base via x402 (CDP facilitator settles).
4. Retry the same `GET` with the `Payment-Signature` header (or `X-Payment` legacy alias).
5. Receive HTTP 200 with the JSON or CSV payload.

### Endpoint #1 URLs

- **Product page:** https://gleaming-cassata-d41682.netlify.app/hardware-wallet-intent-data/
- **JSON (paid):** https://gleaming-cassata-d41682.netlify.app/api/x402/trend-intent-raw-signal-json
- **CSV (paid):** https://gleaming-cassata-d41682.netlify.app/api/x402/trend-intent-raw-signal-csv
- **MCP (streamable-http):** https://gleaming-cassata-d41682.netlify.app/api/mcp

### Endpoint #1 payment details

- **Price:** $0.01 USDC per request on Base via x402.
- **Network:** `eip155:8453` (Base mainnet).
- **Asset:** `0x833589fcd6edb6e08f4c7c32d4f71b54bda02913` (USDC on Base).
- **payTo:** `0x84c2e2ec19a4b467D89fE3F008591DEEA884d9Ac`
- **Scheme:** `exact`
- **Facilitator:** CDP (Coinbase Developer Platform).

### Endpoint #1 output schema (14 columns)

`row_id`, `topic`, `query_or_tag`, `source_class`, `evidence_class`, `public_title`, `public_snippet`, `source_domain`, `captured_at`, `search_volume_monthly`, `difficulty`, `buyer_intent_score`, `confidence_score`, `payout_currency_relevance`

---

## Endpoint #2: LION Marketplace Visibility Audit - public beta paid route

> **Status: public beta paid x402 route. Newly launched 2026-05-27. Awaiting first external buyer.**
>
> LION payment rail is proven by prior controlled Endpoint #1 settlements. Endpoint #2 reuses the same rail. **No external paid proof has been claimed for this endpoint.**

### Tagline

Are agents able to discover and pay your x402/MCP service?

### Why an agent should pay endpoint #2

Use this endpoint when your agent needs to diagnose whether an x402 or MCP service is discoverable, callable, and payable by other agents. Returns a structured JSON report listing the leaks in the audited service's discovery and payment surface, ranked by remediation impact.

### Endpoint #2 paid endpoint

- **Paid URL:** `https://gleaming-cassata-d41682.netlify.app/api/x402/marketplace-visibility-audit-json`
- **Method:** `GET`
- **Required query param:** `?url=<https URL of the x402/MCP seller endpoint to audit>`
- **Price:** `$0.05 USDC` per audit on Base via x402 (50000 atomic USDC).
- **Network:** `eip155:8453`
- **Asset:** `0x833589fcd6edb6e08f4c7c32d4f71b54bda02913` (USDC on Base)
- **payTo:** `0x84c2e2ec19a4b467D89fE3F008591DEEA884d9Ac`
- **Scheme:** `exact`
- **Auth:** none. **PII:** none.

### Agent flow (endpoint #2)

1. `GET /api/x402/marketplace-visibility-audit-json?url=<https-url-to-audit>`
2. Receive HTTP `402` with x402 v2 payment requirements in the body and a `Payment-Required` response header.
3. Pay 50000 atomic USDC (= `$0.05`) on Base via x402 (CDP facilitator settles).
4. Retry the same `GET` (with the same `?url=` and the `Payment-Signature` header).
5. Receive HTTP `200` with the audit JSON report.

### Endpoint #2 validation errors (before payment)

- `GET` with no `?url=` parameter → HTTP `400`, body `{"error":"invalid_audit_url","reason":"url_missing"}`
- `GET` with `?url=` that is not a valid https URL → HTTP `400`, body `{"error":"invalid_audit_url","reason":"url_unparseable"}`
- `GET` with a valid `?url=` → HTTP `402` with x402 v2 payment requirements

### What the audit checks

- `/.well-known/x402.json` availability and shape
- unpaid 402 body validity (x402 v2 `paymentRequirements`)
- `payTo` / `amount` / `asset` / `network` / `scheme` consistency across 402 body, well-known, registry listings
- x402scan listing presence and freshness
- MCP Registry listing presence and version freshness
- `/llms.txt`, OpenAPI, `agents.json` presence
- Bazaar extension (`extensions.bazaar`) shape and `discoverable` flag
- top remediation recommendations ranked by expected discoverability lift

### Endpoint #2 alternative: free first-pass audit by email

Email `lionmaster.operations@gmail.com` with subject `[LION Visibility Audit Request]` and the endpoint URL you want audited in the body. Same JSON output shape as the paid route. One-business-day turnaround during public beta.

Spec page: https://gleaming-cassata-d41682.netlify.app/x402-marketplace-visibility-audit/

---

## Discovery surfaces (both endpoints)

- [`.well-known/x402.json`](https://gleaming-cassata-d41682.netlify.app/.well-known/x402.json) — lists both endpoints with full payment-terms metadata
- [x402scan](https://www.x402scan.com/server/ff6b9887-818c-4491-90eb-61f533e69741)
- [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=lion-mcp) (name: `io.github.LIONMASTER20/lion-mcp` v1.0.0)
- [Glama](https://glama.ai/mcp/connectors/io.github.LIONMASTER20/lion-mcp)
- [Smithery](https://smithery.ai/servers/io.github.LIONMASTER20/lion-mcp)
- [Agentic.Market / Coinbase Bazaar — Endpoint #1 validator](https://agentic.market/validate?url=https%3A%2F%2Fgleaming-cassata-d41682.netlify.app%2Fapi%2Fx402%2Ftrend-intent-raw-signal-json) (validator: Found on Bazaar, x402 v2)
- [Agentic.Market / Coinbase Bazaar — Endpoint #2 validator](https://agentic.market/validate?url=https%3A%2F%2Fgleaming-cassata-d41682.netlify.app%2Fapi%2Fx402%2Fmarketplace-visibility-audit-json) (Endpoint #2 newly launched 2026-05-27)

## Sibling machine-readable files (this directory)

- [server.json](./server.json) - MCP Registry server manifest
- [x402.json](./x402.json) - x402 service descriptor (both endpoints)
- [openapi.json](./openapi.json) - OpenAPI 3 spec for both paid routes
- [agents.json](./agents.json) - agent-readable service descriptor (both endpoints)
- [llms.txt](./llms.txt) - one-screen LLM-crawler summary (both endpoints)
- [visibility-audit.json](./visibility-audit.json) - Endpoint #2 detailed descriptor
- [visibility-audit.md](./visibility-audit.md) - Endpoint #2 human overview
- [examples/curl.md](./examples/curl.md) - curl quickstart (Endpoint #1)
- [SECURITY.md](./SECURITY.md) - security disclosure pointer

## Tags

x402, MCP, USDC, Base, AI agents, agent-commerce, paid API, machine-readable data, crypto data, hardware wallets, audit, discoverability, public beta