Griphook
Griphook is an MCP server enabling AI assistants to interact with the STRATO blockchain's DeFi ecosystem through 67 tools for reading data and executing transactions.
Read Operations:
Tokens & Balances: Fetch token catalog, user balances, voucher balances, earning assets, and token history
Swap Pools: Inspect pools, LP positions, supported token pairs, pool details, and price history
Lending: View lending pools, loans, liquidity, collateral positions, liquidation opportunities, and safety module state
CDP Vaults: Monitor vaults, assets, debt metrics, bad debt, interest rates, and statistics
Bridge: Track bridge networks, bridgeable tokens, deposit/withdrawal history, and transaction summaries
Rewards: Check rewards overview, user activities, pending balances, and leaderboard standings
Admin & Governance: View user profiles, administrators, open governance issues, contract details, and protocol configuration
Events: Search and query on-chain events
Protocol Revenue: Fetch aggregated or per-protocol fee/revenue data (CDP, lending, swap, gas)
RPC Proxy: Execute raw JSON-RPC requests through the backend router
Write Operations:
Token Management: Create tokens (admin), transfer, approve spending allowances, transfer on behalf of others, set token status (admin)
Swap Operations: Create pools, add/remove liquidity (single or dual-sided), execute swaps with slippage protection
Lending: Supply/withdraw collateral, borrow/repay USDST (including max amounts), deposit/withdraw liquidity, stake/unstake in safety module, execute liquidations, configure parameters (admin), sweep reserves (admin), set debt ceilings (admin), pause/unpause operations (admin)
CDP Vaults: Deposit/withdraw collateral, mint/repay USDST (including max amounts), liquidate positions, manage junior notes (open/top-up/claim), configure collateral parameters (admin), toggle asset support (admin), pause/unpause operations (admin)
Bridge: Request withdrawals to external chains and auto-save transactions
Rewards: Claim CATA rewards from RewardsChef, claim rewards for specific activities, or claim all rewards
Administration & Governance: Add/remove administrators, cast votes on proposals, dismiss governance issues, set oracle prices (admin)
⚠️ Security: Requires OAuth 2.0 authentication. Can move funds and change on-chain state—use with caution.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Griphook Check my token balances and active lending positions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| |
Testnet |
|
Visit the login URL to sign in and get a token
Add to your MCP config (e.g.,
.mcp.jsonfor 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 buildCreate .env from .env.sample, then set at least:
STRATO_API_BASE_URLorSTRATO_NODE_URLOPENID_DISCOVERY_URLOAUTH_CLIENT_IDOAUTH_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 logoutTool 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 --jsonImportant CLI behavior:
node dist/cli.jswith no command starts the MCP server (servemode).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-secretTestnet 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-secretCommon CLI Recipes
Most commands below require an active login (node dist/cli.js login).
Show available tools:
node dist/cli.js toolsShow inputs for a specific tool:
node dist/cli.js tools strato.tokensFetch token + voucher balances (current user):
node dist/cli.js strato.tokens --includeBalances --jsonFetch token catalog (can be large):
node dist/cli.js strato.tokens --includeTokens --status eq.2 --jsonInspect swap pools and your LP positions:
node dist/cli.js strato.swap --includePositions --jsonInspect a specific token pair in swap:
node dist/cli.js strato.swap --tokenA <tokenA-address> --tokenB <tokenB-address> --jsonFetch lending dashboard with interest:
node dist/cli.js strato.lending --includeInterest --jsonFetch CDP overview with stats:
node dist/cli.js strato.cdp --includeStats --jsonFetch rewards and leaderboard:
node dist/cli.js strato.rewards --includeLeaderboard --leaderboardLimit 20 --jsonSearch chain events:
node dist/cli.js strato.events --limit 25 --order block_timestamp.desc --jsonRun against another environment without editing .env:
STRATO_API_BASE_URL=https://app.strato.nexus/api \
node dist/cli.js strato.tokens --includeBalances --jsonRunning 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 2.0 client ID |
| OAuth 2.0 client secret |
| OpenID Connect discovery endpoint |
Required for Server and CLI API Calls
Variable | Default | Description |
|
| STRATO API base URL |
| unset | Alternative node base URL. If set and |
|
| HTTP request timeout (ms) |
STRATO_API_BASE_URL takes precedence over STRATO_NODE_URL.
HTTP Transport
Variable | Default | Description |
|
| Enable HTTP transport |
|
| Bind address |
|
| Port |
Hosted Mode
Variable | Description |
| 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 startThe 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 |
| Set OAuth env vars before |
| Check credentials and discovery URL |
| Token expired - run |
| Check |
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 |
|
|
Claude Code |
|
|
Codex |
|
|
Kilo Code |
|
|
Cline |
|
|
OpenCode |
|
|
VS Code Copilot |
|
|
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
Security
This tool can move funds and change on-chain state. Treat it accordingly.
Credentials are stored unencrypted at
~/.griphook/credentials.json(file0600, dir0700). Protect your filesystem.HTTP transport binds to
127.0.0.1without TLS. Keep it local or front with HTTPS + auth if exposed.Report vulnerabilities privately to maintainers rather than opening public issues.
Available Tools
67 toolsstrato.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
Scored across 67 tools
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 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.
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.
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
Related MCP Connectors
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Agent MCP: 65 tools — 5-chain verification, risk, prediction & crypto trends, 17 web tools.
Agent MCP: 65 tools — 5-chain verification, risk, prediction & crypto trends, 17 web tools.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
AlicenseCqualityDmaintenanceAn MCP server providing unified access to blockchain operations, bridging, swapping, and crypto trading strategies for AI agents.37178GPL 3.0- AlicenseNot gradedqualityFmaintenanceAn 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 npm2MIT
- AlicenseNot gradedqualityDmaintenanceA 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.3MIT
- AlicenseAqualityDmaintenanceMCP 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.16MIT