AgentlyHQ / aixyz

aixyz Framework for bundling AI agents into deployable services with A2A, MCP, x402 payments, and ERC-8004 identity. Write your agent logic. aixyz wires up the protocols, payments, and deployment. Prerequisites Install Bun if you don't have it: Quick Start Your agent is running. It exposes: | Endpoint | Protocol | What it does | | ------------------------------ | -------- | ------------------------------------ | | | A2A | Agent discovery card | | | A2A | JSON-RPC endpoint, x402 payment gate | | | MCP | Tool sharing with MCP clients | How It Works An aixyz agent has three parts: a config, an agent, and tools. • Config declares your agent's identity, payment address, and skills: • Agent defines your agent, its payment price, and A2A capabilities: • Tools Each file in exports a Vercel AI SDK and an optional for MCP payment gating: That's it. Run and aixyz auto-generates the server, wires up A2A + MCP + x402, and starts serving. Custom Server For full control, create instead. This takes precedence over auto-generation: Configuration | Field | Type | Required | Description | | -------------- | -------------- | -------- | -------------------------------------------------- | | | | Yes | Agent display name | | | | Yes | What the agent does | | | | Yes | Semver version | | | | No | Agent base URL. Auto-detected on Vercel | | | | Yes | EVM address to receive payments | | | | Yes | Payment network ( for Base) | | | | No | Skills your agent exposes (used in A2A agent card) | Environment variables are loaded in the same order as Next.js: , , , . Payment (Accepts) Each agent and tool declares an export to control payment: Agents and tools without an export are not registered. CLI Starts a local dev server with hot reload. Watches and for changes. Bundles your agent for deployment. Default output goes to . Register your agent's on-chain identity (ERC-8004). Creates if it doesn't exist, asks for your deployment URL, and writes the registration back to the file after a successful on-chain transaction. Update the metadata URI of a registered agent. Reads registrations from and lets you select which one to update. Protocols **A2A (Agent-to-Agent)** — Generates an agent card at and a JSON-RPC endpoint at . Protocol version 0.3.0. Other agents discover yours and send tasks via JSON-RPC. **MCP (Model Context Protocol)** — Exposes your tools at using . Any MCP client (Claude Desktop, VS Code, Cursor) can connect and call your tools. **x402** — HTTP 402 micropayments. Clients pay per-request with an header containing cryptographic payment proof. No custodial wallets, no subscriptions. Payments are verified on-chain via a facilitator. **ERC-8004** — On-chain agent identity. Register your agent on Ethereum, Base, Polygon, Scroll, Monad, BSC, or Gnosis so other agents and contracts can reference it. Agent File Structure Environment Variables | Variable | Description | | ---------------------- | ------------------------------------------------------------------------ | | | Default payment recipient address | | | Default payment network (e.g. ) | | | Custom facilitator (default: ) | | | Coinbase CDP API key ID (uses Coinbase facilitator) | | | Coinbase CDP API key secret | | | Enable experimental Stripe payment adapter | | | OpenAI API key (for agents using OpenAI models) | Examples | Example | Description | | ------------------------- | ----------------------------------------------- | | | Minimal starter (auto-generated server) | | | Chainlink data feeds with custom server | | | Flight search with Stripe payments | | | Local LLM via Docker (no external API) | | | Bring-your-own x402 facilitator | | | Custom server setup | | | Express middleware integration | | | Multiple A2A endpoints from one deployment | | | Agent with test examples | | | Fully deterministic testing with model | Contributing License MIT