SDK

`@conc-exe/agent`

Discover Concierge routes, settle with x402 or TCX, call intel — no API keys. Optional: prepare and link ERC-8004 Identity mints on Base.

v0.1.0 · packages/agent · Sister: @conc-exe/token-x402

Quick start

Install once. Verify in the browser.

Same flow as the SDK — MCP, discover, unpaid call — without leaving the docs.

npm install @conc-exe/agent

01 MCP
02 Discover
03 Call

Route Message

agent · setup Ready

Ready when you are.

Press Run setup check to probe this origin.

payCurl

Pay in Playground pay.sh

402 is expected without payment. This lab never moves funds.

quickstart.ts

import { createConciergeAgent, PaymentRequiredError } from "@conc-exe/agent";

const agent = createConciergeAgent({
  origin: "https://conc-exe.xyz",
});

const snap = await agent.discover();
console.log(snap.catalog.length, snap.mcpUrl);

try {
  const { body } = await agent.intel.verdict({
    message: "DeFi outlook on Solana",
  });
  console.log(body);
} catch (e) {
  if (e instanceof PaymentRequiredError) {
    console.log(agent.payCurl("intel-verdict", {
      message: "DeFi outlook on Solana",
    }));
  }
}

Settle hook

Wire a wallet once; unpaid calls get a 402 challenge, then the client retries:

const agent = createConciergeAgent({
  async settlePayment({ accepts, paymentRequiredHeader }) {
    return await yourWallet.signX402(paymentRequiredHeader, accepts);
  },
});

const { body } = await agent.call("intel-macro", {});

Without an in-process wallet, use pay.sh or the Live lab above.

Surfaces

API	Role
`discover()`	well-known x402 + OpenAPI + agent card + A2A mesh
`catalog()`	Offline kind → path → price (24 routes)
`call(kind, body)` · `intel.` · `security.`	Paid POST
`a2aMesh()` / `agentCard()`	Free discovery
`agentRegistration(agtId)`	EIP-8004 registration file (`agentURI`)
`prepareErc8004(agtId)` / `linkErc8004({ id, agentId, txHash })`	Base Identity Registry mint prepare + link
`payCurl(kind)`	Shell hint for agents

Same intel surface over MCP: /api/mcp (v1.1).

ERC-8004 mint still needs a signer with ETH on Base (Lounge UI or your wallet). SDK helpers only prepare/link — see Agent identity.

ERC-8004 identity (optional)

After you register agt_… and mint on the Base Identity Registry, link the tokenId back to Concierge:

const prep = await agent.prepareErc8004("agt_…");
// prep.agentURI → pass to register(agentURI) on-chain from the agent EVM wallet
await agent.linkErc8004({
  id: "agt_…",
  agentId: "123",       // on-chain tokenId
  txHash: "0x…",
});

Lounge one-click: /lounge#agent-identity

Agent identity / ERC-8004 — register + Base mint
MCP Registry — Cursor / Claude / Hermes
pay.sh — CLI settlement
Intel APIs · Security Desk
Playground · Discover UI

Back to lab MCP guide Playground

Concierge · @conc-exe/agent

@conc-exe/agent

Settle hook

Surfaces

ERC-8004 identity (optional)

Related

`@conc-exe/agent`