Product

Architecture

How Concierge runs on Executive Lounge.

  • UIexecutive-lounge.html, x402-pay.mjs, agent-identity.mjs
  • APIs — Vercel Edge /api/*
  • AI — Google Gemini 2.5 Flash (default; text + image) · optional GLM-4.7 Flash (Z.ai) for chat
  • Payments — x402 v2 · PayAI (primary) + Dexter fallback · USDC on Base / Solana · Token Pay native SPL self-settle (multi-merchant)
  • Storage — Redis/KV (signals, RWA, agent registry, lounge memory)
  • Trust — optional zauth directory + Provider Hub telemetry

Data sources

SourceUsed for
DeFi LlamaTVL, EVM/Solana yield pools
Meteora DLMM APILive DLMM pools, APY, TVL (dlmm.datapi.meteora.ag)
Binance futuresTop-trader positioning (whale proxy)
Fear & GreedSentiment in verdict
HeliusSolana wallet snapshot (when RPC has api-key)
Wire RSS + Lounge KVHeadlines, creator signals (insider)
Wikipedia / newsGeneral knowledge block in chat
Z.ai (GLM)Optional chat model (agentModel: glm-4.7-flash)

Concierge pipeline

  1. Validate origin + body · x402 gate
  2. Fetch market snapshot, DeFi intel (parallel, timeouts)
  3. Build system prompt (category playbooks + live blocks)
  4. LLM generate (Gemini default; GLM when agentModel set) → HTML reply
  5. Report paid route to zauth (async, optional)

Configuration

VariablePurpose
GEMINI_API_KEYConcierge AI (required)
GLM_API_KEYOptional GLM-4.7 Flash chat (agentModel)
X402_EVM_PAY_TO / X402_SOL_PAY_TOUSDC receive addresses
TOKEN_PAY_MERCHANTS_JSONPartner Token Pay merchants — see integration guide
SOON_TOKEN_MINTDefault SOON merchant mint (post-launch)
KV_REST_*Signals, agents, memory
SOLANA_RPC_URLHelius for wallet + NFT mint proxy
ZAUTH_API_KEYProvider Hub telemetry (optional)
X402_SITE_ORIGINCanonical URL for discovery

Operator markdown: repository docs/ folder. Never commit secrets.

Discovery & registries

Implementation: api/lib/mpp-discovery.ts · api/lib/x402-discovery.ts · Edge handlers openapi.ts, well-known-x402.ts

  • pay.shpay --sandbox curl https://conc-exe.xyz/api/concierge-intel-tvl -d '{}' · guide
  • MPPscanlisted server · OpenAPI x402 + mpp protocols
  • AgentCashnpx agentcash add https://conc-exe.xyz
  • x402scanoptional registration
  • zauthGET /api/zauth-directory · GET /api/zauth-status

Docs: pay.sh · MPP & AgentCash

Concierge · Executive Lounge