Skip to content

gizatechxyz/giza-hub

Repository files navigation

Giza Hub

Monorepo for the Giza developer platform and AI Agents — SDK, MCP server, and plugin and Skills for autonomous DeFi yield management.

Packages

Package Description
@gizatech/agent-sdk TypeScript SDK for smart account creation, agent lifecycle, and portfolio monitoring
@gizatech/mcp-server MCP server exposing Giza tools for AI assistants (OAuth, Redis-backed sessions, Vercel-ready)
giza-skills Claude Code plugin with guided DeFi workflows — onboarding, portfolio, withdrawals, rewards

Quick start

Prerequisites

  • Bun >= 1.0
  • A Giza partner API key — contact gizatech.xyz to obtain credentials

Environment variables

GIZA_API_KEY=your-partner-api-key
GIZA_API_URL=your-api-url
GIZA_PARTNER_NAME=your-partner-name

Install the SDK

bun add @gizatech/agent-sdk
import { Giza, Chain } from "@gizatech/agent-sdk";

const giza = new Giza({ chain: Chain.BASE });

const agent = await giza.createAgent(
  "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
);
console.log("Smart Account:", agent.wallet);

await agent.activate({
  owner: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  token: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  protocols: ["aave", "compound"],
  txHash: depositTxHash,
});

const { apr } = await agent.apr();

Use the MCP server

Connect any MCP-compatible client (Claude Desktop, Claude Code, Cursor) to the hosted server:

{
  "mcpServers": {
    "giza": {
      "type": "sse",
      "url": "https://mcp.gizatech.xyz/api/sse"
    }
  }
}

See the MCP server README for self-hosting and local development.

Install the skill

From ClawHub:

npx clawhub@latest install giza

Or as a Claude Code plugin:

/plugin marketplace add gizatechxyz/giza-hub
/plugin install giza-skills

See the plugin README for details and supported networks.

SDK tools

Group Tools
Wallet connect_wallet, disconnect_wallet
Account create_smart_account, get_smart_account
Protocol get_protocols, get_tokens, get_stats
Lifecycle activate_agent, deactivate_agent, top_up
Portfolio get_portfolio, get_performance, get_apr, get_deposits
Financial withdraw, get_withdrawal_status, get_transactions, get_fees

Supported networks

  • Base (8453) — default, includes Giza Rewards program
  • Arbitrum (42161) — USDC
  • Plasma (9745) — USDT0
  • HyperEVM (999) — USDT0

Examples

bun run --filter @gizatech/agent-sdk example:agent

Development

bun install

# SDK
cd packages/sdk && bun run build

# MCP server (local)
cd packages/mcp-server && cp .env.example .env && bun run dev

# Plugin (local)
claude --plugin-dir ./plugins/giza-skills

License

MIT

Releases

No releases published

Packages

 
 
 

Contributors