GnoPulse MCP
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GNOTX_BIN | No | Use your own gnotx build. Defaults to the bundled binary. | |
| GNO_CHAIN_ID | No | Chain ID, also passed to the signer by the launcher. | gnoland-1 |
| GNO_RPC_URLS | No | Comma-separated RPC endpoints, tried in order. Defaults to public gnoland-1 RPCs. | |
| GNOPULSE_SIGNER | No | Signer mode. Options: user-approval, microservice, tee, or none (simulate only). Default is 'user-approval' with npx, otherwise 'none'. | |
| GNOPULSE_API_KEY | No | GnoPulse API key used by data and analytics tools. | |
| GNOPULSE_API_BASE | No | GnoPulse API base URL. | https://gnopulse.xyz |
| GNOPULSE_MCP_HOST | No | HTTP listen host. | 127.0.0.1 |
| GNOPULSE_MCP_PORT | No | HTTP listen port. | 8080 |
| GNOTX_SERVICE_URL | No | Signing service URL (the launcher sets it). | http://127.0.0.1:8787 |
| GNO_GRC20_REGISTRY | No | GRC20 registry realm. | gno.land/r/nt/grc20reg/v0 |
| GNOPULSE_AGENT_HOME | No | Agent keybase and signer state. | ~/.gnopulse-agent |
| GNOTX_SERVICE_TOKEN | No | Signing service bearer token (the launcher sets it). | |
| GNOPULSE_SIGNER_ADDR | No | Local signer address. | 127.0.0.1:8899 |
| GNOPULSE_MCP_TRANSPORT | No | MCP transport. Use 'http' for Streamable HTTP. | stdio |
| GNOPULSE_MCP_TIMEOUT_MS | No | API and RPC request timeout. | 15000 |
| GNOPULSE_POLICY_DEFAULT | No | Policy default. Use 'deny' to reject every call when no allow rule is set. | allow |
| GNOPULSE_MCP_REQUIRE_KEY | No | Set to '1' to reject HTTP sessions without an API key. | |
| GNOPULSE_POLICY_FEES_ONLY | No | Set to '1' to allow calls but no value transfer. | |
| GNOPULSE_POLICY_DENY_FUNCS | No | Never allow these functions (comma-separated). | |
| GNOPULSE_POLICY_EXPIRES_AT | No | Session expiry as a unix time. | |
| GNOPULSE_POLICY_EXPIRES_IN | No | Session expiry in seconds. | |
| GNOPULSE_POLICY_ALLOW_FUNCS | No | Only these functions are allowed (comma-separated). | |
| GNOPULSE_POLICY_DENY_REALMS | No | Never allow these realms (comma-separated). | |
| GNOPULSE_POLICY_ALLOW_REALMS | No | Only these realms are allowed (comma-separated). | |
| GNOPULSE_POLICY_MAX_SEND_UGNOT | No | Maximum native ugnot sent per transaction. Does not cover GRC20 approve or swap amounts. Default is 5000000 with npx, otherwise none. | 5000000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| gno_api_usageB | Read current quota headers through one standard block-list request. This request consumes its normal cost units. |
| gno_get_accountC | Wallet overview for a g1… address: activity, counts, labels. |
| gno_get_transactionsA | Recent classified transactions, newest first, cursor-paginated. Filter by app label or success. For a specific wallet's activity use gno_wallet_transfers. |
| gno_get_blockB | Block detail by height: transactions, proposer, time. |
| gno_get_eventsC | Emitted Gno events grouped by realm and type, with filters. |
| gno_get_packageC | Realm or package detail: metadata, deployer, functions. |
| gno_searchC | Full-text search across realms, tokens, wallets, transactions, and blocks. |
| gno_token_holdersC | Holder distribution for a GRC20 token. |
| gno_pricesA | Token prices sourced from GnoSwap. Pass a token for one price, or omit it for all. |
| gno_ohlcvC | OHLCV candles for a token. |
| gno_poolsA | GnoSwap pools: token pair, fee tier and creation details, with each pool's market figures under |
| gno_smart_moneyC | Wallets ranked by realized PnL. |
| gno_mevB | Same-pool, same-block sandwich-pattern candidates. Not general MEV or arbitrage detection. |
| gno_holder_seriesC | Holder-count time series for a token. |
| gno_launch_radarC | Newly launched tokens and pools. |
| gno_labelB | Resolve an address to known entity and app labels (e.g. GnoSwap, faucet). |
| gno_whalesB | Largest whale-labeled wallets by net worth, excluding contracts. |
| gno_dev_activityB | Recent launches with creator holdings and creator-sell (rug) signals. |
| gno_nft_holdingsA | Cursor-paginated GRC721 NFTs a wallet owns across all collections. Includes GnoSwap LP positions (each is an NFT). Prefer this over gno_grc721 for 'what does X own'. |
| gno_nft_collectionC | A GRC721 collection's holders, supply, and distribution. |
| gno_wallet_pnlB | Realized and unrealized PnL for a wallet across its trades. |
| gno_wallet_transfersA | A wallet's incoming and outgoing coin transfers, newest first, cursor-paginated. |
| gno_wallet_tokensC | A wallet's current GRC20 token balances. |
| gno_wash_tradesC | Transaction-netted round-trip activity. Heuristic only, not proof of wash trading or common ownership. |
| gno_swap_signalsB | Settled swap events with price impact. Page with cursor=next_cursor; offset is retained for compatibility. Optionally filter by pool or signing wallet. |
| gno_pool_depthC | Liquidity depth profile for a GnoSwap pool. |
| gno_pool_lp_providersC | Indexed contributions, raw amounts and nullable current-price estimates, with separately verified current position owners. Events page by before; contributors page by offset. |
| gno_blocksA | Recent blocks, newest first, cursor-paginated. One block: gno_get_block. |
| gno_realmsA | Indexed realms and packages with activity counts, offset-paged. For one package use gno_get_package. |
| gno_functionsC | How often each realm function is called, filterable by app label or a text match on the name. |
| gno_failed_callsB | Failed transactions with the raw chain error and an error class; filter by realm or class. |
| gno_realm_graphB | Which realms and packages import which. scope=overview for the whole chain, ego with root for one package's neighbourhood. |
| gno_discoveriesC | Packages discovered on chain, newest first. |
| gno_librariesC | Pure packages (gno.land/p/...) with how many realms import them. |
| gno_libraryA | One library: event breakdown, the realms that call it and its deployment. Unknown paths are not_found. |
| gno_gpao_queueA | Mainnet package-approval queue: waiting, enabled and blocked packages. Other networks answer unsupported_query. |
| gno_gpao_packageB | One package's GPAO approval record; tracked=false when GPAO never saw it. |
| gno_governanceB | GovDAO proposals, newest first, with per-tier voting power. Votes per proposal: gno_governance_votes. |
| gno_governance_votesC | Votes cast on one GovDAO proposal. |
| gno_validatorsC | Validator set with voting power, share, recent uptime and registered valopers. |
| gno_bridgesA | Every bridge stack (IBC, Union, Hyperlane): connected chains, clients, vouchers and escrow. |
| gno_bridge_transfersB | Cross-chain transfers across all bridge stacks, newest first, cursor-paginated. |
| gno_wrapsC | Standalone GNOT to wugnot wraps and unwraps, newest first. |
| gno_sparklinesC | Coarse activity buckets across the whole indexed range. |
| gno_healthA | Indexer and classifier health, chain tip versus indexed tip, and data freshness. |
| gno_dex_analyticsB | Venue and per-pool TVL, 24h/7d volume, fee and emission APR, and per-token volume. Costs expensive units. |
| gno_dex_seriesC | DEX volume over time for the whole venue or one pool. |
| gno_pool_ohlcvB | OHLCV candles for one pool's pair. For a token's candles across pools use gno_ohlcv. |
| gno_pool_tradesC | Recent settled swaps for one pool (the tape) plus whole-pool stats. |
| gno_swap_hopsC | Multi-hop swaps leg by leg, as executed. |
| gno_dex_quoteA | Read-only GnoSwap router quote for a known route, fee included once. Find a route with gno_dex_route. |
| gno_dex_routeB | Best route between two tokens from bounded direct and two-hop discovery; discloses its search scope. |
| gno_token_directoryB | Every token from every source with trust, price state (priced, quoted, no_market) and holder count. |
| gno_price_listA | Every token's price (VWAP with oracle cross-check). One token: gno_prices. Costs expensive units. |
| gno_launchpadC | Launch venue markets: bonding-curve launches with graduation progress and zDex pools. |
| gno_launch_quoteB | Read-only bonding-curve quote. Unsafe curve states answer quote_unavailable instead of a number. |
| gno_launch_snipersC | Sniper activity on one launch pool. |
| gno_cvdC | Buy minus sell pressure over time for one token. Costs expensive units. |
| gno_wallet_flowsC | Wallets with repeated sizeable net flows over a window. Costs expensive units. |
| gno_known_entitiesC | Labeled entities such as whales, arbitrageurs and distributors. |
| gno_wallet_defiB | GnoSwap liquidity positions (held or staked), fees, rewards and delegated GNS. pending=true means retry after meta.retry_after. |
| gno_wallet_realmsC | Which realms a wallet has called, with counts. |
| gno_wallet_clusterB | Funding cluster for an address: wallets funded from the same source. A signal, not proof of common ownership. |
| gno_evalA | Evaluate a read-only Gno expression against a realm via ABCI vm/qeval, e.g. |
| gno_renderB | Fetch a realm's Render(path) output via ABCI vm/qrender: the markdown page the realm serves at gno.land/r/…:path. |
| gno_package_filesA | List a package's source files (vm/qfile) and exported function signatures (vm/qfuncs). |
| gno_get_balancesB | Native coin balances (ugnot etc.) and account number/sequence for an address, via ABCI auth/accounts. |
| gno_statusA | Chain tip: latest height, chain ID, and block time, plus which RPC endpoint answered. |
| gno_token_registryA | List every GRC20 token in the on-chain GRC20 registry. Returns the token keys expected by gno_token_metadata and gno_token_balance. New and IBC tokens register themselves here. |
| gno_token_metadataA | Name, symbol, decimals, and total supply for a GRC20 token, read via the registry. On-chain decimals can be a placeholder (e.g. wugnot reports 0 but uses 6); use gno_prices for authoritative display decimals and USD price. |
| gno_token_balanceA | Exact on-chain GRC20 balance of an address, in raw units (divide by 10^decimals). For native ugnot use gno_get_balances. |
| gno_grc721A | Best-effort read of a GRC721 NFT realm via its standard getters. Null fields mean the realm does not expose that getter. Pass owner for a balance and/or tokenId for owner and URI. To list the NFTs an address owns, use gno_nft_holdings. |
| gno_agent_statusA | The agent's own on-chain identity: the address this MCP signs with (use it as your caller or recipient), its ugnot balance and sequence, the chain, whether execution is enabled, and the active policy bounds. Call this first, before acting, to learn your address and whether you can pay gas. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 73 tools
The descriptions are detailed and often cross-reference the correct alternative tool, but the set contains many closely related analytics endpoints (e.g. gno_pools, gno_pool_depth, gno_pool_trades, gno_dex_analytics; gno_prices vs gno_price_list; gno_ohlcv vs gno_pool_ohlcv). An agent can usually distinguish them with careful reading, but there are enough overlapping concepts that misselection is likely without the descriptions.
All tool names use a consistent gno_ snake_case prefix and are readable as resource/action phrases. The main deviation is that some retrieval tools use an explicit get_ verb (gno_get_account, gno_get_block) while most use bare nouns or domain-specific names.
Seventy-three tools is far above an agent-friendly range and creates a large selection burden even for a broad blockchain analytics server. Many tools are fine-grained variants of the same domains, so the surface feels over-expanded rather than tightly scoped.
The surface covers a wide range of Gno data domains: pools/DEX analytics, tokens, NFTs, wallets, governance, bridges, packages, search, and raw ABCI queries. Minor gaps remain, such as a clear transaction-by-hash detail endpoint and any write/execution tools, though the latter may be outside the intended read-only analytics scope.