us-agents

UNITED STATES OF AGENTS is a multi-chain agentic infrastructure designed to bridge the gap between Autonomous Agents and finance (DeFi). The platform provides a standardized environment where AI agents can be registered, managed, and equipped with the tools necessary to perform complex on-chain operations—specifically focusing on cross-chain liquidity movement. We created a openCLaw skill named circle-mcp skill.

🏗️ System Architecture

The ecosystem is built on a robust three-tier stack:

The USAgents Platform: An application that serves as the command center. It utilizes MongoDB and Prisma ORM for persistent storage, organizing agents into functional "Departments" (e.g., Treasury, Operations). All internal communication is secured via tRPC, ensuring end-to-end type safety and validated data flow.

MCP (Model Context Protocol) Server: This acts as the "translator" between Large Language Models (LLMs) and the blockchain. By implementing the MCP standard, USAgents allows any AI model to treat blockchain functions—like checking a balance or initiating a swap—as native tools. It supports both STDIO for local integration and HTTP/SSE for remote, scalable deployments.

Multi-Protocol Bridging: The project integrates : Circle's CCTP/Gateway for capital-efficient USDC transfers across 8 testnets, and the Li.Fi SDK for comprehensive multi-token routing across multiple major EVM mainnets.

🔧 Intelligent On-Chain Capabilities

An agent can define its chain and for the long future whatever chain maybe it receives its funds the default chain where agent will receive it is his own.

UYSC works as a collatoral asset if agent is onboarded by circle then the agent swaps automatically any underlying assets into yield appreciating RWA.

USDC Native Bridging: Utilizing Circle’s Gateway, agents can execute complex EIP-712 signing workflows to burn and mint USDC across disparate networks, ensuring zero slippage and high security.

ICE Department works into registering agents and their ENS names into the registry and allows complex operations using it it also does not expose agents wallet address rather gives out it's own agent.base.eth name defined by the openclaw user.

Universal Token Swaps: With the Li.Fi integration, agents can perform "any-to-any" swaps. If an agent needs to move value from Polygon to Base while changing the asset type, the Li.Fi SDK automatically calculates the most efficient route.

Automated Governance & Logging: Every action an agent takes is authenticated via encrypted tokens and logged within the MongoDB database. This provides a transparent audit trail for "Department" leads to monitor agent performance and task completion.

🌟 Why This Matters

In the current fragmented blockchain landscape, AI agents often struggle with "siloed" liquidity. USAgents solves this by providing a country for agents where an agent doesn't need to know the underlying complexities of cross-chain protocols. Whether it’s managing a treasury across 8 testnets or optimizing yield on mainnet, USAgents provides the infrastructure for the next generation of "On-Chain Employees."

The core philosophy was to treat blockchain protocols not as APIs, but as skills that an agent can learn.

Here's how it was pieced together: 🛠️ The Tech Stack:

The Model Context Protocol (MCP): Instead of writing custom JSON-RPC calls for every agent, we built a server that adheres to the MCP standard. This means an agent (like those running on OpenClaw) can "handshake" with our server and instantly see tools like bridge_usdc as native functions.

Built on Next.js 15 (App Router) for the management dashboard, and the MCP (Model Context Protocol) Server layer.

Type-Safe Foundation: We used Prisma with MongoDB to track agent "state." In a multi-agent system, knowing which agent owns which sub-wallet is critical. tRPC was used to ensure that when the frontend asks for an agent's task history, the data is perfectly typed from the database to the UI.

Wallet Orchestration: We used Viem for low-level EVM interactions. It handles the EIP-712 typed data signing required for Circle’s Gateway.

🤝 Partner Integrations:

Circle BridgeKit & Gateway:Using Circle's SDK, we gained access to CCTP (Cross-Chain Transfer Protocol). This allowed our agents to "burn" USDC on one chain and "mint" it on another without relying on risky third-party liquidity pools.

Li.Fi SDK: While Circle handles USDC, Li.Fi acts as our routing engine. If an agent wants to move "Value" but doesn't care about the asset, Li.Fi finds the most gas-efficient path across multiple mainnets. It handles the complex "swapping logic" (e.g., ETH on Arbitrum → USDC on Base) in a single tool call.

We handled Transaction Progress. Standard HTTP calls time out, and blockchain transactions are slow using streamable mcp servers.

The SSE Hack: To give agents real-time feedback without the overhead of WebSockets, we implemented Server-Sent Events (SSE) in the HTTP transport mode. This allows the MCP server to "stream" the status of a bridge (e.g., "Step 1: Approving USDC...", "Step 2: Burning on Source...") directly to the agent's context window. This prevents the LLM from "hallucinating" that a transaction failed just because it's taking 30 seconds to confirm.

🔓 Opening DeFi via OpenClaw

By integrating with OpenClaw, we are effectively giving a locally-running AI assistant reach into the DeFi ecosystem. OpenClaw provides the user interface , while USAgents provides the Arc and multichain infra This combination allows users to say, "Hey, move my idle USDC to the chain with the lowest gas," and the infrastructure handles the signing, bridging, and logging autonomously.