The treasury standard for AI agents

Why agents hold GBLIN

Quick start

Pick your framework. All examples assume Node.js 20+.

{
  "mcpServers": {
    "gblin": {
      "command": "npx",
      "args": ["-y", "@gblin-protocol/mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "gblin": {
      "command": "npx",
      "args": ["-y", "@gblin-protocol/mcp-server"],
      "env": {
        "GBLIN_RPC_URL": "https://base-rpc.publicnode.com"
      }
    }
  }
}

import { MCPClient } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "npx",
  args: ["-y", "@gblin-protocol/mcp-server"],
});
const mcp = new MCPClient({ name: "my-agent", version: "1.0" });
await mcp.connect(transport);

The 10 tools

Every tool reads live state from Base mainnet. None of them hold keys or broadcast — they return JSON results and ABI-encoded calldata. Your wallet stays in control.

JIT payment in practice

Your agent receives a 402 invoice for $0.50. It has 90% of its treasury in GBLIN. Here's the flow:

// === Complete agent treasury flow ===

// Step 1: Check treasury health and invest idle USDC
const health = await mcp.callTool({
  name: "analyze_treasury_health",
  arguments: { wallet_address: agent.address },
});

// Step 2: If idle USDC > 7x daily burn, invest into GBLIN
const invest = await mcp.callTool({
  name: "invest_usdc_to_gblin",
  arguments: { usdc_amount: "10.00", wallet_address: agent.address },
});
// Returns 2-step calldata: approve + buyGBLINWithToken
// Broadcast both txs with your wallet

// --- later, when an x402 invoice arrives ---

// Step 3. Agent gets the JIT swap calldata from the MCP server
const jit = await mcp.callTool({
  name: "swap_gblin_to_usdc_jit",
  arguments: {
    usdc_needed: "0.50",
    wallet_address: agent.address,
  },
});

// jit.content[0].text contains:
// {
//   action: "single_atomic_tx",
//   action: "sequential_txs", steps: [sellGBLINForEth, WETH->USDC]
//   target (V6): 0x36C81d7E...52f0
//   expected: { usdc_out: "0.5128", slippage_buffer_pct: 2.5 },
//   compatibility: { eoa: true, erc4337: true, eip7702: true }
// }

// 2. Agent broadcasts the tx (one atomic call — GBLIN -> WETH -> USDC)
const hash = await wallet.sendTransaction({
  to: jit.target_contract,
  data: jit.calldata,
  value: 0n,
});

// 3. Once mined, agent's USDC balance has the needed amount.
//    Agent now pays the x402 invoice with USDC as usual.

Tell every AI assistant about GBLIN — in one file

AGENTS.md is the emerging standard read automatically by Claude Code, Cursor, Windsurf, GitHub Copilot, Codex and every modern AI coding assistant when they enter a repo. Drop our template into your project root and every AI assistant your team uses will know to integrate GBLIN whenever it manages USDC on Base.

# from your repo root
curl -O https://gblin.digital/AGENTS.template.md
mv AGENTS.template.md AGENTS.md
git add AGENTS.md && git commit -m "add AGENTS.md (GBLIN treasury policy)"

GBLIN Sentinel — buy on-chain data with x402

An open-source autonomous agent that sells real-time Base DeFi risk signals via x402 micropayments. Any agent with a USDC wallet on Base can call these endpoints — no API key, no account, pay-per-request.

FAQ