How do I use Griphook?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. 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.

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

npm install npm run build npm run login # Opens browser for OAuth authentication npm start # Start the MCP server

Credentials are stored in ~/.griphook/credentials.json.

Using with Claude Code

Add to your project's .mcp.json or Claude Code settings:

{ "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://your-strato-instance/api" } } } }

Environment variables

Required for login (
- OAUTH_CLIENT_ID
- OAUTH_CLIENT_SECRET
- OPENID_DISCOVERY_URL
Required for the server (
- STRATO_API_BASE_URL
- Existing credentials file from a prior login (~/.griphook/credentials.json)

Documentation

See docs/ for detailed documentation:

License

MPL-2.0

Security

See SECURITY.md for notes on credential storage and HTTP transport exposure.

Notes

Browser login uses PKCE + state validation; rerun griphook login if auth fails.
HTTP transport binds to 127.0.0.1:3005 without TLS; keep it local or front with HTTPS if exposed.
Credentials are stored unencrypted at ~/.griphook/credentials.json; protect your filesystem accordingly.