gage-sdk and gage-mcp

Borrow and earn on gage from your own code or AI agent. gage makes fixed-cost loans with no liquidation: a loan is never closed early because a price moves, and if it is not repaid by the end of its term the lenders keep the collateral and nothing else is taken. It runs on Robinhood Chain.

Quickstart: your app

npm install gage-sdk viem

import { createGage, privateKeySigner } from "gage-sdk";

const gage = createGage(); // Robinhood Chain; createGage({ network: "testnet" }) for its testnet

// What 1 NVDA borrows for 7 days. Reads only: no key.
const { assets } = await gage.assets();
const nvda = assets.find((a) => a.symbol === "NVDA")!;
const quote = await gage.borrowQuote({ token: nvda.token, maxCollateral: "1000000000000000000", term: 604800 });
console.log(quote.summary); // Pledge 1 NVDA, receive 187.80 USDG, repay 189.86 USDG within 7 days

// Borrow it with your own key: the exact approval first, every step simulated before it is sent.
const signer = privateKeySigner(process.env.WALLET_KEY!);
const { action: _, ...terms } = quote.prepare;
const { loan } = await gage.run({ action: "borrow", ...terms }, signer);

Amounts are raw integers as decimal strings (USDG has 6 decimals, tokens their own), times are seconds.

Related MCP server: pai

Quickstart: your AI agent

npx -y gage-mcp init                      # the agent's own wallet on this computer: prints its address, never its key
claude mcp add gage -- npx -y gage-mcp    # Claude Code
codex mcp add gage -- npx -y gage-mcp     # Codex

Fund that wallet with only what the agent may use, and a little ETH for gas. The agent then borrows and earns when you ask, under spend limits: at most 100 USDG a loan, loop or deposit, and 250 USDG of loans and 250 USDG of deposits in any 24 hours, unless you change them (off lifts one).

To sign every step yourself instead, connect your agent to gage's hosted server, https://mcp.gage.cash/mcp: it prepares, and you confirm each step on gage.cash.

What you can do

Every action can be prepared (prepare: the next unsigned transaction, for any wallet) or carried out (run, with your signer). gageTools(gage) gives your own agent framework the tools gage's MCP servers serve.

What it will not do

• Hold your key, or sign anything gage's own planner did not build: no tool sends arbitrary calldata.

• Fund a loan directly: lending is a deposit into a partner vault.

• Read or act on private loans.

• Approve more than a transaction needs. Leaving a loan to roll by itself is the one standing approval, and its plan says so.

Defaults

• Robinhood Chain (4663) since 0.6.0, with real money. The testnet is network: "testnet", or GAGE_NETWORK=testnet for gage-mcp.

• Every step is simulated before it is sent, and a refusal comes as a fixed code (TERM_NOT_ALLOWED, INSUFFICIENT_BALANCE, …), listed in each package's README.

• gage-mcp signs under its spend limits unless its owner lifts them.

Examples

packages/sdk/examples and packages/mcp/examples, typechecked and tested in CI, every action they ask for checked against the schema the SDK takes:

Run one from packages/sdk after pnpm install && pnpm build: npx tsx examples/quote.ts NVDA.

Docs and changes

• Guides: every integration path, each with its example, and on docs.gage.cash the SDK and the MCP servers

• Reference: every method, action and tool (generated from the SDK itself), and the gage-sdk and gage-mcp READMEs

• Changes: gage-sdk and gage-mcp changelogs

Develop

Node 22 or later and pnpm 9:

pnpm install
pnpm build
pnpm typecheck
pnpm lint
pnpm test

How this repository is kept

gage's main repository, where the contracts, the app and gage's services live, is the source of these two packages. Each release is copied here as one commit, and npm's copy is published from this repository with provenance. Issues and pull requests are welcome: see CONTRIBUTING.md.

Asking gage for something

• A token gage should accept: List a token.

• An integration, a Rates API key, or your site's origin for browser access to the rates service: Integrate with gage. A key is sent to your private contact, never posted in an issue.

• Help with a loan, a deposit or the app: support. The docs: docs.gage.cash.

Security

Report a vulnerability privately, never in an issue or a pull request: see SECURITY.md. Both packages are in scope of gage's bug bounty.

License

MIT