Griphook

Provides access to STRATO data and actions via MCP, enabling reads, swaps, lending, bridging, and governance participation.

javascript

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Griphook is a Model Context Protocol (MCP) server that connects AI assistants to the STRATO blockchain platform. It enables your AI to read on-chain data, perform actions like swaps and lending operations, and participate in governance, all through a structured MCP interface.

How to use

You connect an MCP client to Griphook to access STRATO data and actions. Start the server, authenticate, and then configure your MCP client to point at Griphook. Once connected, your AI can read balances, liquidity pools, and vault states, execute swaps and lending operations, bridge assets, claim rewards, and participate in governance voting.

To enable easy integration with your Claude-based workflow, configure Griphook as an MCP server in your project settings. The server runs locally and communicates via a standard MCP channel. The server process stores credentials locally after you log in.

The server exposes its data and actions through a local runtime. It binds to a local address to keep interactions private unless you explicitly expose it. If you ever need to re-authenticate, run the login flow again and repeat the steps to start the server.

{
  "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"
      }
    }
  }
}

How to install

Prerequisites: ensure you have Node.js and npm installed on your system. You will also need access to a browser for OAuth login during setup.

Step by step commands to set up and run Griphook locally:

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

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

## Configuration and usage notes

Environment variables shown below are required for login and for running the server. Ensure these are available in your environment when you start the server and when you perform the login flow.

OAUTH_CLIENT_ID OAUTH_CLIENT_SECRET OPENID_DISCOVERY_URL STRATO_API_BASE_URL

These variables are used during `griphook login` and `griphook serve`.

Tools and capabilities

Griphook provides access to a broad set of MCP tools to interact with STRATO. You can use them to read data, perform actions, and manage governance.

Key capabilities include reading token balances, reading swap pools and lending positions, accessing CDP vaults, and monitoring protocol metrics. You can execute swaps, lending operations, borrowing, bridging assets, and claiming rewards. You can also manage platform administration and participate in governance voting.

Available tools

Read balances

Read on-chain balances for tokens held by an address, including token balances and related metrics.

Read pools

Read liquidity pools, swap pools, and related protocol metrics.

Read lending

Read lending positions and related metrics across markets.

Read cdps

Read CDP vault states and collateralization data.

Read governance

Read governance proposals, voting power, and related metrics.

Execute swap

Execute token swaps on supported pools.

Lend/borrow

Execute lending operations and borrowing against collateral.

Bridge

Bridge assets across supported chains or layers.

Claim rewards

Claim earned rewards from staking or liquidity programs.

Governance vote

Submit or manage governance votes.

Built by

VeilStrat

AI signals for GTM teams