Skip to main content
Glama

Griphook

███████╗████████╗██████╗  █████╗ ████████╗ ██████╗
██╔════╝╚══██╔══╝██╔══██╗██╔══██╗╚══██╔══╝██╔═══██╗
███████╗   ██║   ██████╔╝███████║   ██║   ██║   ██║
╚════██║   ██║   ██╔══██╗██╔══██║   ██║   ██║   ██║
███████║   ██║   ██║  ██║██║  ██║   ██║   ╚██████╔╝
╚══════╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝    ╚═════╝

 ██████╗ ██████╗ ██╗██████╗ ██╗  ██╗ ██████╗  ██████╗ ██╗  ██╗
██╔════╝ ██╔══██╗██║██╔══██╗██║  ██║██╔═══██╗██╔═══██╗██║ ██╔╝
██║  ███╗██████╔╝██║██████╔╝███████║██║   ██║██║   ██║█████╔╝
██║   ██║██╔══██╗██║██╔═══╝ ██╔══██║██║   ██║██║   ██║██╔═██╗
╚██████╔╝██║  ██║██║██║     ██║  ██║╚██████╔╝╚██████╔╝██║  ██╗
 ╚═════╝ ╚═╝  ╚═╝╚═╝╚═╝     ╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝

Griphook is an MCP (Model Context Protocol) server that connects AI agents to the STRATO blockchain platform.

What is STRATO?

STRATO is a blockchain platform with a comprehensive DeFi ecosystem including token management, decentralized exchange, lending markets, CDP vaults, cross-chain bridging, and governance.

Related MCP server: Sui Butler

What is Griphook?

Griphook lets AI assistants like Claude interact with STRATO. Through 67 MCP tools, your AI can:

  • Read token balances, swap pools, lending positions, CDP vaults, and protocol metrics

  • Execute swaps, lending operations, borrowing, bridging, and reward claims

  • Manage platform administration and governance voting

Quick Start

Public hosted instances are available for both production and testnet:

Environment

Login URL

MCP Endpoint

Production

https://griphook.strato.nexus/login

https://griphook.strato.nexus/mcp

Testnet

https://griphook.testnet.strato.nexus/login

https://griphook.testnet.strato.nexus/mcp

  1. Visit the login URL to sign in and get a token

  2. Add to your MCP config (e.g., .mcp.json for Claude Code):

{
  "mcpServers": {
    "griphook": {
      "type": "http",
      "url": "https://griphook.strato.nexus/mcp",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}

See AI Coding Tool Compatibility for tool-specific configurations.

Using the CLI Locally

Build and run the local CLI:

npm install
npm run build

Create .env from .env.sample, then set at least:

  • STRATO_API_BASE_URL or STRATO_NODE_URL

  • OPENID_DISCOVERY_URL

  • OAUTH_CLIENT_ID

  • OAUTH_CLIENT_SECRET

CLI auth + basic commands:

node dist/cli.js login
node dist/cli.js status
node dist/cli.js token
node dist/cli.js logout

Tool discovery and invocation:

node dist/cli.js tools
node dist/cli.js tools strato.tokens
node dist/cli.js strato.tokens --includeBalances
node dist/cli.js strato.tokens --includeBalances --json

Important CLI behavior:

  • node dist/cli.js with no command starts the MCP server (serve mode).

  • Tool flags are schema-validated: unknown flags fail fast.

  • Non-boolean flags require a value, for example --tokenAddress <value>.

  • --no-<flag> is only valid for boolean inputs.

  • Credentials are stored at ~/.griphook/credentials.json.

.env Examples

Mainnet example:

STRATO_API_BASE_URL=https://app.strato.nexus/api
OPENID_DISCOVERY_URL=https://keycloak.blockapps.net/auth/realms/mercata/.well-known/openid-configuration
OAUTH_CLIENT_ID=your-client-id
OAUTH_CLIENT_SECRET=your-client-secret

Testnet example:

STRATO_API_BASE_URL=https://buildtest.mercata-testnet.blockapps.net/api
OPENID_DISCOVERY_URL=https://keycloak.blockapps.net/auth/realms/mercata/.well-known/openid-configuration
OAUTH_CLIENT_ID=your-client-id
OAUTH_CLIENT_SECRET=your-client-secret

Common CLI Recipes

Most commands below require an active login (node dist/cli.js login).

Show available tools:

node dist/cli.js tools

Show inputs for a specific tool:

node dist/cli.js tools strato.tokens

Fetch token + voucher balances (current user):

node dist/cli.js strato.tokens --includeBalances --json

Fetch token catalog (can be large):

node dist/cli.js strato.tokens --includeTokens --status eq.2 --json

Inspect swap pools and your LP positions:

node dist/cli.js strato.swap --includePositions --json

Inspect a specific token pair in swap:

node dist/cli.js strato.swap --tokenA <tokenA-address> --tokenB <tokenB-address> --json

Fetch lending dashboard with interest:

node dist/cli.js strato.lending --includeInterest --json

Fetch CDP overview with stats:

node dist/cli.js strato.cdp --includeStats --json

Fetch rewards and leaderboard:

node dist/cli.js strato.rewards --includeLeaderboard --leaderboardLimit 20 --json

Search chain events:

node dist/cli.js strato.events --limit 25 --order block_timestamp.desc --json

Run against another environment without editing .env:

STRATO_API_BASE_URL=https://app.strato.nexus/api \
  node dist/cli.js strato.tokens --includeBalances --json

Running Your Own Instance

To run your own Griphook server, add to .mcp.json:

{
  "mcpServers": {
    "griphook": {
      "command": "node",
      "args": ["/path/to/griphook/dist/cli.js", "serve"],
      "env": {
        "OAUTH_CLIENT_ID": "your-client-id",
        "OAUTH_CLIENT_SECRET": "your-client-secret",
        "OPENID_DISCOVERY_URL": "https://keycloak.blockapps.net/auth/realms/mercata/.well-known/openid-configuration",
        "STRATO_API_BASE_URL": "https://buildtest.mercata-testnet.blockapps.net/api"
      }
    }
  }
}

Environment Variables

Required for Login

Variable

Description

OAUTH_CLIENT_ID

OAuth 2.0 client ID

OAUTH_CLIENT_SECRET

OAuth 2.0 client secret

OPENID_DISCOVERY_URL

OpenID Connect discovery endpoint

Required for Server and CLI API Calls

Variable

Default

Description

STRATO_API_BASE_URL

http://localhost:3001/api

STRATO API base URL

STRATO_NODE_URL

unset

Alternative node base URL. If set and STRATO_API_BASE_URL is unset, Griphook appends /api automatically.

STRATO_HTTP_TIMEOUT_MS

15000

HTTP request timeout (ms)

STRATO_API_BASE_URL takes precedence over STRATO_NODE_URL.

HTTP Transport

Variable

Default

Description

GRIPHOOK_HTTP_ENABLED

true

Enable HTTP transport

GRIPHOOK_HTTP_HOST

127.0.0.1

Bind address

GRIPHOOK_HTTP_PORT

3005

Port

Hosted Mode

Variable

Description

GRIPHOOK_PUBLIC_URL

Public URL (enables multi-user auth)

Deploying a Hosted Instance

Set GRIPHOOK_PUBLIC_URL to enable multi-user deployment with per-request authentication. You'll also need to add the redirect URI https://<your-domain>/login/callback to your Keycloak client.

GRIPHOOK_PUBLIC_URL=https://griphook.testnet.strato.nexus npm start

The server exposes /.well-known/oauth-protected-resource (RFC 9728). MCP clients with OAuth support authenticate automatically.
Hosted mode accepts either:

  • a user access token (JWT) from an active OAuth session, or

  • a refresh token (from /login) which the server exchanges for an access token.

See deployment guide for full setup including Keycloak, DNS, nginx, and SSL configuration.

Troubleshooting

Error

Solution

OPENID_DISCOVERY_URL ... required

Set OAuth env vars before npm run login

Failed to acquire access token

Check credentials and discovery URL

403 Forbidden

Token expired - run npm run login again

ECONNREFUSED

Check STRATO_API_BASE_URL points to running instance

AI Coding Tool Compatibility

Griphook works with any MCP-enabled AI coding tool. You can either reuse an active OAuth access token, or sign in at /login to get a token for tool configuration.

Supported Tools

Tool

Config File

Type Field

Cursor

.cursor/mcp.json or ~/.cursor/mcp.json

http

Claude Code

.mcp.json or ~/.claude.json

http

Codex

~/.codex/config.toml

http

Kilo Code

.kilocode/mcp.json

streamable-http

Cline

cline_mcp_settings.json

streamableHttp

OpenCode

opencode.json or ~/.config/opencode/opencode.json

remote

VS Code Copilot

.vscode/mcp.json

http

Example Configurations

Cursor (.cursor/mcp.json or ~/.cursor/mcp.json):

{
  "mcpServers": {
    "griphook": {
      "type": "http",
      "url": "https://griphook.strato.nexus/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Claude Code (.mcp.json or ~/.claude.json):

{
  "mcpServers": {
    "griphook": {
      "type": "http",
      "url": "https://griphook.strato.nexus/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.griphook]
type = "http"
url = "https://griphook.strato.nexus/mcp"

[mcp_servers.griphook.headers]
Authorization = "Bearer <your-token>"

Kilo Code (.kilocode/mcp.json):

{
  "mcpServers": {
    "griphook": {
      "type": "streamable-http",
      "url": "https://griphook.strato.nexus/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Cline (cline_mcp_settings.json):

{
  "mcpServers": {
    "griphook": {
      "type": "streamableHttp",
      "url": "https://griphook.strato.nexus/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

OpenCode (opencode.json):

{
  "mcp": {
    "griphook": {
      "type": "remote",
      "url": "https://griphook.strato.nexus/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

VS Code Copilot (.vscode/mcp.json):

{
  "servers": {
    "griphook": {
      "type": "http",
      "url": "https://griphook.strato.nexus/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Known Issues

  • Cursor: Tools may appear in the sidebar but not be callable in chat. Try using global config (~/.cursor/mcp.json) and restart Cursor.

  • VS Code Copilot: Requires VS Code 1.102+ with Agent Mode enabled (chat.agent.enabled).

License

MPL-2.0

Security

This tool can move funds and change on-chain state. Treat it accordingly.

  • Credentials are stored unencrypted at ~/.griphook/credentials.json (file 0600, dir 0700). Protect your filesystem.

  • HTTP transport binds to 127.0.0.1 without TLS. Keep it local or front with HTTPS + auth if exposed.

  • Report vulnerabilities privately to maintainers rather than opening public issues.

Available Tools

67 tools
strato.adminAdmin and governanceC

Fetch current user profile, admins, open issues, contract search, and config.

Inputs: search, contractAddress, includeConfig.

strato.admin.add-adminAdd adminC

Grant administrator access.

Inputs: userAddress (required).

strato.admin.dismiss-issueDismiss governance issueC

Dismiss an issue (only proposer only-voter case).

Inputs: issueId (required).

strato.admin.remove-adminRemove adminC

Revoke administrator access.

Inputs: userAddress (required).

strato.admin.voteCast voteD

Cast an administrative vote.

Inputs: target (required), func (required), args (required).

strato.admin.vote-by-idCast vote by issue IDC

Cast a vote given an issue ID.

Inputs: issueId (required).

strato.bridgeBridge networks and activityC

Fetch bridge network configs, bridgeable tokens, deposit/withdrawal history, and withdrawal summary.

Inputs: chainId, txType, limit, offset, +2 more.

strato.bridge.request-auto-saveBridge request auto saveD

Request auto save for a bridge transaction.

Inputs: externalChainId (required), externalTxHash (required).

strato.bridge.request-withdrawalBridge request withdrawalC

Submit a withdrawal request to an external chain.

Inputs: externalChainId (required), stratoToken (required), stratoTokenAmount (required), externalRecipient (required), +1 more.

strato.cdpCDP overviewC

Fetch CDP vaults, assets, debt metrics, bad debt, and interest/stats.

Inputs: asset, includeStats, includeInterest.

strato.cdp.claim-junior-noteClaim junior noteD

Claim junior note rewards.

Inputs: no named parameters.

strato.cdp.depositCDP deposit collateralC

Deposit collateral into a vault.

Inputs: asset (required), amount (required).

strato.cdp.liquidateCDP liquidateC

Liquidate an unhealthy CDP position.

Inputs: collateralAsset (required), borrower (required), debtToCover (required).

strato.cdp.mintCDP mint USDSTC

Mint USDST against collateral.

Inputs: asset (required), amount (required).

strato.cdp.mint-maxCDP mint maxD

Mint maximum safe USDST.

Inputs: asset (required).

strato.cdp.open-junior-noteOpen junior noteC

Open a junior note position for bad debt.

Inputs: asset (required), amountUSDST (required).

strato.cdp.repayCDP repayC

Repay USDST debt.

Inputs: asset (required), amount (required).

strato.cdp.repay-allCDP repay allC

Repay all debt for an asset.

Inputs: asset (required).

strato.cdp.set-asset-pausedCDP pause assetC

Admin: toggle pause for a collateral asset.

Inputs: asset (required), isPaused (required).

strato.cdp.set-asset-supportedCDP set asset supportedD

Admin: toggle asset support.

Inputs: asset (required), supported (required).

strato.cdp.set-collateral-configCDP set collateral configD

Admin: set collateral parameters.

Inputs: asset (required), liquidationRatio (required), liquidationPenaltyBps (required), closeFactorBps (required), +5 more.

strato.cdp.set-collateral-config-batchCDP batch collateral configC

Admin: set multiple collateral configs.

Inputs: assets (required), liquidationRatios (required), liquidationPenaltyBpsArr (required), closeFactorBpsArr (required), +5 more.

strato.cdp.set-global-pausedCDP global pauseC

Admin: toggle global CDP pause.

Inputs: isPaused (required).

strato.cdp.top-up-junior-noteTop up junior noteC

Add USDST to junior note.

Inputs: amountUSDST (required).

strato.cdp.withdrawCDP withdraw collateralC

Withdraw collateral from a vault.

Inputs: asset (required), amount (required).

strato.cdp.withdraw-maxCDP withdraw maxC

Withdraw maximum safe collateral.

Inputs: asset (required).

strato.eventsEvent searchC

Query chain events through the backend search interface.

Inputs: order, limit, offset.

strato.lendingLending dashboardC

Fetch lending pools, loans, liquidity, collateral, liquidations, and safety module state.

Inputs: includeInterest, includeNearUnhealthy.

strato.lending.borrowBorrow USDSTC

Borrow from lending pool.

Inputs: amount (required).

strato.lending.borrow-maxBorrow maxB

Borrow the maximum available USDST.

Inputs: no named parameters.

strato.lending.configure-assetConfigure lending assetC

Admin: set lending parameters.

Inputs: asset (required), ltv (required), liquidationThreshold (required), liquidationBonus (required), +3 more.

strato.lending.deposit-liquidityDeposit pool liquidityC

Deposit into lending pool.

Inputs: amount (required), stakeMToken (required).

strato.lending.liquidateExecute liquidationC

Liquidate a lending loan.

Inputs: id (required), collateralAsset, repayAmount, minCollateralOut.

strato.lending.pausePause lending poolC

Admin: pause lending.

Inputs: no named parameters.

strato.lending.repayRepay loanC

Repay outstanding debt.

Inputs: amount (required).

strato.lending.repay-allRepay all loansC

Repay all debt.

Inputs: no named parameters.

strato.lending.safety-cooldownStart safety cooldownC

Begin safety module cooldown.

Inputs: no named parameters.

strato.lending.safety-redeemRedeem safetyD

Redeem sUSDST shares.

Inputs: sharesAmount (required), includeStakedSToken (required).

strato.lending.safety-redeem-allRedeem all safetyC

Redeem all sUSDST shares.

Inputs: no named parameters.

strato.lending.safety-stakeSafety stakeC

Stake USDST into safety module.

Inputs: amount (required), stakeSToken (required).

strato.lending.set-debt-ceilingsSet debt ceilingsC

Admin: set global/per-asset debt ceilings.

Inputs: assetUnits (required), usdValue (required).

strato.lending.supply-collateralSupply collateralC

Supply collateral to lending pool.

Inputs: asset (required), amount (required).

strato.lending.sweep-reservesSweep reservesC

Admin: sweep protocol reserves.

Inputs: amount (required).

strato.lending.unpauseUnpause lending poolC

Admin: unpause lending.

Inputs: no named parameters.

strato.lending.withdraw-collateralWithdraw collateralC

Withdraw supplied collateral.

Inputs: asset (required), amount (required).

strato.lending.withdraw-collateral-maxWithdraw max collateralC

Withdraw maximum available collateral for an asset.

Inputs: asset (required).

strato.lending.withdraw-liquidityWithdraw pool liquidityC

Withdraw from lending pool.

Inputs: amount (required), includeStakedMToken.

strato.lending.withdraw-liquidity-allWithdraw all pool liquidityB

Withdraw all available liquidity.

Inputs: no named parameters.

strato.oracle.set-priceSet oracle priceC

Admin: set oracle price for an asset.

Inputs: token (required), price (required).

strato.protocol-feesProtocol revenueB

Fetch aggregated or per-protocol revenue summaries.

Inputs: protocol, period.

strato.rewardsRewards overviewC

Fetch rewards overview, activities, user rewards, pending balances, and leaderboard.

Inputs: userAddress, includeLeaderboard, leaderboardLimit, leaderboardOffset.

strato.rewards.claimClaim Chef rewardsB

Claim all pending CATA rewards from RewardsChef.

Inputs: no named parameters.

strato.rewards.claim-activityClaim activity rewardsC

Claim rewards for a specific activity.

Inputs: activityId (required).

strato.rewards.claim-all-activitiesClaim all rewardsC

Claim all rewards across activities.

Inputs: no named parameters.

strato.rpcRPC proxyC

Proxy a JSON-RPC request through the backend RPC router.

Inputs: chainId (required), payload (required).

strato.swapSwap pools and liquidityC

Inspect swap pools, supported tokens, LP positions, history, and specific pool details.

Inputs: tokenA, tokenB, poolAddress, includePositions, +3 more.

strato.swap.add-liquidityAdd dual-sided liquidityC

Provide both tokens to a pool.

Inputs: poolAddress (required), tokenBAmount (required), maxTokenAAmount (required), stakeLPToken.

strato.swap.add-liquidity-singleAdd single-sided liquidityC

Provide liquidity using only one token.

Inputs: poolAddress (required), singleTokenAmount (required), isAToB (required), stakeLPToken.

strato.swap.create-poolCreate swap poolC

Create a new swap pool between tokenA and tokenB.

Inputs: tokenA (required), tokenB (required), isStable.

strato.swap.executeExecute swapD

Swap within an existing pool.

Inputs: poolAddress (required), isAToB (required), amountIn (required), minAmountOut (required).

strato.swap.remove-liquidityRemove liquidityC

Redeem LP tokens from a pool.

Inputs: poolAddress (required), lpTokenAmount (required), includeStakedLPToken.

strato.tokensTokens and balancesC

Fetch token catalog, user balances, voucher balance, and earning assets.

Inputs: status, includeTokens, includeStats, includeEarningAssets, +3 more.

strato.tokens.approveApprove spenderC

Approve allowance for a spender.

Inputs: address (required), spender (required), value (required).

strato.tokens.createCreate tokenC

Admin: create a new token.

Inputs: name (required), symbol (required), initialSupply (required), description (required), +4 more.

strato.tokens.set-statusSet token statusC

Admin: update token status.

Inputs: address (required), status (required).

strato.tokens.transferTransfer tokenC

Transfer tokens to another address.

Inputs: address (required), to (required), value (required).

strato.tokens.transfer-fromTransfer fromC

Transfer tokens on behalf of another address.

Inputs: address (required), from (required), to (required), value (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 67 tools

    Disambiguation4/5

    Tools are well-organized by domain (admin, bridge, cdp, lending, etc.) with clear distinctions within each category. However, some pairs like strato.cdp.mint and strato.cdp.mint-max or strato.lending.borrow and strato.lending.borrow-max have overlapping purposes that could cause confusion, though descriptions clarify the 'max' variants.

    Naming Consistency5/5

    Naming follows a highly consistent pattern: all tools use snake_case with a clear domain prefix (strato.<domain>) and descriptive action names. The structure is uniform across all 67 tools, making them predictable and easy to parse.

    Tool Count2/5

    With 67 tools, the count is excessive for a single server, even for a comprehensive DeFi platform. This many tools will overwhelm agents, increase cognitive load, and likely lead to misselection or inefficiency. A more modular approach with separate servers per domain would be more appropriate.

    Completeness5/5

    The toolset provides extensive coverage across multiple DeFi domains (admin, bridge, CDP, lending, rewards, swap, tokens). Each domain includes full CRUD/lifecycle operations, administrative controls, and user actions, leaving no obvious gaps for the intended functionality.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      An MCP server for the Sui blockchain that enables AI agents to manage accounts, execute token swaps, and perform smart contract development using the Sui CLI. It supports over 30 tools for DeFi operations, staking, and market data via Pyth price oracles.
      20 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server providing unified access to over 144 tools for lending, trading, and staking across six major DeFi protocols on the Stacks Bitcoin Layer 2. It enables AI agents to perform complex blockchain operations and interact with the DeFi ecosystem using natural language commands.
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server providing AI agents with native access to Jupiter's full DeFi stack on Solana. It offers 17 tools covering swaps, tokens, lending, limit orders, DCA, prediction markets, perpetuals, and portfolio management.
      16
      MIT