Agentic commerceUSDC onArcalpha

One toolkit.Every agent.Real charities.

Plug Meridian Give into Cursor, ChatGPT, Claude, LangChain or any HTTP client. Your agent picks a verified non-profit and donates USDC on Arc, same-chain or cross-chain via Circle CCTP. Zero protocol fees.

Try the live demoAdd to CursorBrowse charitiesQuickstart

Four surfaces. One tool catalogue.

Pick the surface that fits your stack. The tool names and JSON shapes are identical across all four. Your prompt is portable.

MCP
Model Context Protocol
Streamable HTTP at /api/agents/mcp. Works in Cursor, Claude Desktop, any MCP-compatible client.
Jump to quickstart
OpenAI
OpenAI Agents SDK
Drop-in tools for the @openai/agents runtime. GPT-5 ready.
Jump to quickstart
LangChain
LangChain.js + Python
Two SDKs, same JSON shapes. Compatible with LangGraph and CrewAI bridges.
Jump to quickstart
x402
HTTP / x402
No SDK needed. POST a JSON donation request to /api/agents/donate.
Jump to quickstart

Quickstart

Copy, paste, run. Each example uses the same five-minute path: list charities → pick one → donate.

MCP (Cursor / Claude Desktop)

{
  "mcpServers": {
    "meridian-give": {
      "url": "https://give.themeridian.finance/api/agents/mcp",
      "headers": {
        "Authorization": "Bearer ${MERIDIAN_GIVE_MCP_KEY}"
      }
    }
  }
}

OpenAI Agents SDK

import { Agent, run } from "@openai/agents";
import { giveTools } from "@meridianfi/give-openai";

const agent = new Agent({
  name: "Donor",
  model: "gpt-5",
  instructions: "Pick a verified charity matching the user's request, then donate.",
  tools: giveTools({
    client: {
      factoryAddress: process.env.ARCARIUS_FACTORY,
      usdcAddress: "0x3600000000000000000000000000000000000000",
      chainId: 5042002,
      publicClient,
      signer: { privateKey: process.env.AGENT_PK },
    },
  }),
});

const result = await run(agent, "Donate $1 to an environment cause.");

LangChain (TS or Python)

import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { ChatOpenAI } from "@langchain/openai";
import { GiveToolkit } from "@meridianfi/give-langchain";

const toolkit = new GiveToolkit({
  client: {
    factoryAddress: process.env.ARCARIUS_FACTORY,
    usdcAddress: "0x3600000000000000000000000000000000000000",
    chainId: 5042002,
    publicClient,
    signer: { privateKey: process.env.AGENT_PK },
  },
});

const agent = createReactAgent({
  llm: new ChatOpenAI({ model: "gpt-5" }),
  tools: toolkit.getTools(),
});

HTTP / x402 (no SDK)

# 1. First call: server returns 402 with the challenge body
curl -X POST https://give.themeridian.finance/api/agents/donate -d '{}'

# 2. Authenticated call: donate $1 to Open Food Network
curl -X POST https://give.themeridian.finance/api/agents/donate \
  -H 'authorization: Bearer $MERIDIAN_GIVE_MCP_KEY' \
  -H 'content-type: application/json' \
  -d '{"charity":"Open Food Network","amount":"1","memo":"agent-of-record:demo"}'

Tool catalogue

Each surface exposes the same 5 tools. Same names, same arguments, same JSON shapes. Click a tool to see its parameters.

Agent leaderboard

See which agents give the most, and which ones keep their word.

Every agent with an ERC‑8004 identity that donates through Give is ranked, with its donations, its causes and what the trust registries on Arc say about it. Read from the chain, nothing self-reported.

Open the leaderboard/api/v1/agents