# ServerMemoryRFQ — Agent SKILL.md

> **What this is:** ServerMemoryRFQ is the first B2B server-memory marketplace built
> from day one for autonomous AI agent procurement. Agents can discover inventory,
> request quotes, and complete purchases — all on-chain — without API keys, accounts,
> or human gatekeepers.

## Quick Facts

| | |
|---|---|
| **Provider** | ServerMemoryRFQ |
| **Category** | Commerce / Hardware Procurement |
| **Network** | Base (USDC) — Ethereum optional |
| **Payment Protocol** | x402 HTTP 402 Payment Required |
| **Discovery** | `/.well-known/agent-manifest.json`, `/llms.txt`, `/api/agent/x402/` |
| **Auth** | No signup required. Optional `x-api-key` for higher rate limits |

## What an agent can buy

- Enterprise server memory (DDR4, DDR5, DDR5-7200, RDIMMs, LRDIMMs)
- 2,800+ in-stock SKUs from major OEMs (Samsung, SK Hynix, Micron, Crucial)
- TAA-compliant US-stocked inventory
- Configurations from 16 GB up to 256 GB per stick

## Endpoints

### Free (no payment)

| Method | Path | Description |
|---|---|---|
| GET | `/api/agent/inventory` | List in-stock parts, optional filters: `memory_type`, `capacity`, `speed`, `manufacturer` |
| GET | `/api/agent/pricing/{part_number}` | Get unit price, stock count, condition, TAA status |
| GET | `/api/agent/mcp/context` | MCP-compatible context document for tool-using agents |
| GET | `/api/agent/supplier-reputation` | Supplier trust score, fulfillment rate, dispute rate |
| GET | `/api/agent/payments-race` | Public live activity feed (volume, top endpoints, recent tx) |

### Paid via x402 (Base / USDC)

| Method | Path | Price | Description |
|---|---|---|---|
| GET | `/api/agent/x402/feed` | $0.10 | Premium enriched inventory feed: full specs, bin locations, incoming stock, weekly velocity |
| POST | `/api/agent/x402/purchase/{part_number}` | dynamic (unit × qty + shipping) | Autonomous purchase — creates a shippable Web3 order |

## Payment flow (x402 — exact-txhash scheme)

1. Agent hits paid endpoint with **no** `X-PAYMENT` header
2. Server returns **HTTP 402** with `accepts[]` payment requirements (payTo wallet, USDC amount, network)
3. Agent submits standard ERC-20 USDC transfer on Base to the `payTo` address
4. Agent retries the same request with header:
   ```
   X-PAYMENT: base64({"x402Version":1,"scheme":"exact-txhash","network":"base","payload":{"tx_hash":"0x…","from":"0x…"}})
   ```
5. Server verifies tx on-chain via public RPC, returns the resource + `X-PAYMENT-RESPONSE` header with settlement metadata

## Receiving wallets

- **Base** (USDC): `0x299290421e696a76ef1efe77adee23c7629613d7`
- **Ethereum** (USDC): `0x4A82F8bcDEaBcF56C3bE1f22e5b1B333aFae243f`

## Why an agent should use this

- **Escrow-protected:** every purchase enters custodial escrow; releases only on tracking confirmation
- **Reputation:** public buyer/supplier trust scores via `/api/agent/wallet-reputation/{addr}`
- **Disputes:** buyers can file disputes from any wallet via `POST /api/agent/orders/{id}/dispute`
- **Real inventory:** 2,800+ SKUs, all in-stock and shippable from US warehouses

## Example: full purchase flow

```bash
# 1. Discover
curl https://servermemoryrfq.com/api/agent/inventory?memory_type=DDR5&limit=5

# 2. Price a part
curl https://servermemoryrfq.com/api/agent/pricing/M321RAJA0MB2-CJRQZ

# 3. Initiate purchase (returns 402 with payTo)
curl -X POST https://servermemoryrfq.com/api/agent/x402/purchase/M321RAJA0MB2-CJRQZ \
  -H "Content-Type: application/json" \
  -d '{"quantity": 2, "shipping_address": {...}}'

# 4. Pay on-chain (any wallet / SDK) to payTo address from the 402 response

# 5. Retry with X-PAYMENT header — order is created + escrow held
```

## Verify the listing

- x402 root discovery: <https://servermemoryrfq.com/api/agent/x402/>
- Public activity dashboard: <https://servermemoryrfq.com/agent-activity>
- LLM-friendly docs: <https://servermemoryrfq.com/llms.txt>
- Agent manifest: <https://servermemoryrfq.com/.well-known/agent-manifest.json>

---
*ServerMemoryRFQ — built so AI agents never have to fill out a procurement form again.*