0gkit-mcp

@foundryprotocol/0gkit-mcp

The neutral 0G MCP server. Every 0G primitive is exposed as an MCP tool so Claude Desktop / Cursor / Cline / any agent runtime can drive 0G directly — no glue code, no Foundry dependency.

Foundry ships as a separate, opt-in plugin (ZEROG_FOUNDRY=1) and is absent by default. @foundryprotocol/0gkit-* never imports @foundryprotocol/* — this is enforced in CI by pnpm boundary:check.

Tools

Tool	What it does
og_storage_put	Upload bytes to 0G Storage → root + funding tx
og_storage_get	Download a blob by root
og_storage_exists	Is a root retrievable?
og_infer	Chat completion against a 0G compute provider
og_da_publish	Publish a blob to 0G Data Availability
og_da_verify	Recompute a DA digest and compare
og_chain_faucet	Request testnet funds for an address
og_chain_balance	Native 0G balance of an address
og_attest_verify	Verify a TEE attestation (digest + signer)

Every error is a ZeroGError with an actionable hint (missing env var, unreachable endpoint, which attestation check failed).

Use it with Claude Desktop

{
  "mcpServers": {
    "0gkit": {
      "command": "npx",
      "args": ["-y", "@foundryprotocol/0gkit-mcp"],
      "env": {
        "ZEROG_NETWORK": "galileo",
        "ZEROG_PRIVATE_KEY": "0x…",
        "ZEROG_PROVIDER": "0x…"
      }
    }
  }
}

Defaults to the Galileo testnet — no real funds needed. Get testnet funds with the og_chain_faucet tool or https://faucet.0g.ai.

Environment

Var	Purpose
ZEROG_NETWORK	galileo (default), aristotle, or local
ZEROG_RPC_URL	Override the preset RPC
ZEROG_PRIVATE_KEY	Signer key (funds storage uploads)
ZEROG_BROKER_KEY	Funded broker key for inference
ZEROG_PROVIDER	Default 0G inference provider address
ZEROG_FOUNDRY	1 to enable the opt-in Foundry plugin

Programmatic

import { create0gMcpServer } from "@foundryprotocol/0gkit-mcp";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = await create0gMcpServer();
await server.connect(new StdioServerTransport());

Foundry plugin (opt-in)

Set ZEROG_FOUNDRY=1 and install @foundryprotocol/mcp. The neutral server loads its tools (list_ingots, run_inference, get_ingot, get_lineage, get_attestation) via a computed specifier so the neutrality boundary stays green by construction. Without the opt-in, those tools do not appear.

MIT