GBLIN MCP logo

GBLIN MCP

by gblinproject

Manages Base treasury risk, GBLIN swaps, USDC obligations, governance checks, and verifiable AI action receipts over MCP.

Install GBLIN MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gblinproject-gblin-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gblin-protocol/mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 20 tools correctly (1mo ago).

Overview

gblinproject/GBLIN-MCP MCP server gives AI agents Base mainnet tools for monitoring market risk, managing idle USDC through GBLIN, and preparing unsigned swap calldata. It can report treasury state, Crash Shield regimes, governance conditions, wallet runway, and keeper opportunities, while leaving transaction signing to the agent's wallet. Additional tools verify risk attestations and create or retrieve receipts from an append-only transparency log. Use it when an agent needs policy checks before treasury actions, just-in-time USDC conversion, or portable evidence of actions taken.

Use cases

  • Check market risk before deploying treasury capital
  • Park surplus USDC in GBLIN
  • Prepare just-in-time USDC payments from GBLIN
  • Verify a peer agent's risk attestation
  • Create portable receipts for agent actions

Key features

  • Base mainnet treasury monitoring
  • Crash Shield risk-regime checks
  • Unsigned GBLIN and USDC transaction calldata
  • Governance and timelock inspection
  • Risk-attestation verification
  • AI action transparency receipts

Tools20

What GBLIN MCP lets your agent do. Expand a tool for its parameters.

Verified live~4.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

17/43 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · @gblin-protocol/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads2.2kPackage downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed20Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How GBLIN MCP works

What gblinproject/GBLIN-MCP MCP server does

gblinproject/GBLIN-MCP MCP server exposes treasury and risk operations for agents working on Base mainnet. The treasury functions use GBLIN, an index backed by cbBTC, WETH, and USDC, with minting and redemption at NAV as described in the project material. Agents can inspect NAV, basket weights, Crash Shield status, wallet balances, gas runway, and operational runway before deciding whether to deploy or retain capital.

The server also supports the payment side of treasury management. It can prepare calldata to move between GBLIN, ETH, and USDC, including a just-in-time redemption path for an x402 invoice or another USDC obligation. The returned transactions are unsigned; the user's EOA or account-abstraction wallet must authorize them.

How it works

Read-only tools retrieve protocol, market-risk, governance, and wallet information. The risk tool returns one of three regimes—calm, elevated, or crash—along with a severity score and a posture such as risk_on, reduce, or risk_off. Governance checks inspect the GBLIN_V6 owner, timelock settings, role counts, and pending asset-addition proposals.

Swap and investment tools return transaction steps rather than broadcasting them. Investing USDC requires an approval followed by an in-kind GBLIN purchase. JIT redemption uses a GBLIN-to-ETH transaction followed by a Uniswap WETH-to-USDC transaction. Safe minimum outputs include dynamic slippage protection; the stated buffers are 2.5% normally and 4% during Crash Shield conditions.

The receipt tools hash action inputs and outputs, then work with Ed25519 signatures, RFC 6962 Merkle proofs, and signed checkpoints. Receipts can be fetched and verified independently. The demo sealing path is limited to five seals per day per IP, while unlimited paid sealing uses x402.

Setup and configuration

The project publishes an npm package named @gblin-protocol/mcp-server. A local stdio installation can be started with:

Terminal
npx -y @gblin-protocol/mcp-server

A hosted Streamable HTTP MCP endpoint is also provided at https://gblin-mcp.gblin-mcp-worker.workers.dev/mcp. The hosted endpoint is therefore not a complete substitute for the local package.

No API key or wallet is needed to read the free risk information. Wallet keys are not held by the service. Some operations require x402 payments in USDC, including treasury-health analysis, risk-regime queries, keeper-bounty checks, and unlimited receipt sealing.

Tools and capabilities

gblinproject/GBLIN-MCP MCP server includes tools to:

  • Read treasury state, market risk, governance state, and wallet health.
  • Preview GBLIN trades and prepare investment or JIT USDC redemption calldata.
  • Check keeper rebalance opportunities and their stated ETH reward.
  • Verify risk attestations for integrity, signer authenticity, freshness, and live regime drift.
  • Seal action hashes in the public log and retrieve portable receipts.
  • Explain the paid receipt-sealing flow.
  • Generate a portable skill seed for another agent, including a referral code derived from the caller wallet.

Limitations and notes

The material describes the protocol and tool behavior but does not guarantee that a transaction will execute successfully after calldata is returned. Agents still need a compatible wallet, sufficient assets, approvals, and gas, and must sign the transactions themselves. Some tools charge through x402, with the first call used to obtain a payment manifest when _payment is omitted.

The transparency log records hashes plus submitted labels and metadata; those strings are public, so secrets should not be placed in them. Its receipts demonstrate signed, time-stamped inclusion in the log and are not compliance certificates or endorsements. The hosted and npm tool surfaces differ, so client selection should account for which functions are required.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about GBLIN MCP

Run `npx -y @gblin-protocol/mcp-server` for the npm package's local stdio server.

Certain tools use x402 payments in USDC.

The swap tools return unsigned, ready-to-broadcast calldata. Your wallet must sign the transactions; the service does not hold keys.

Yes. The hosted Streamable HTTP endpoint is `https://gblin-mcp.gblin-mcp-worker.workers.dev/mcp`, but its tool set differs from the npm package.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGBLIN MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gblinproject-gblin-mcp?style=directory)](https://allmcps.com/mcp/gblinproject-gblin-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/gblinproject-gblin-mcp"><img src="https://allmcps.com/api/badge/gblinproject-gblin-mcp?style=directory" alt="GBLIN MCP on AllMCPs" /></a>