Gexno Web3

io.github.JanzenChenPublished by GitHub account JanzenChenv0.1.3Updated Oct 29, 2026

Free Ethereum wallet profile & NFT metadata MCP tools (no signup).

The publisher's own server: Web3TV MCP Server

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinance

Overview

AI-generated overview

Free, read-only Ethereum lookups: an assistant can fetch a wallet's ETH balance and simple risk flags, or resolve NFT metadata for a contract and token ID.

What you can do
  • Look up an Ethereum wallet: ETH balance, contract flag, outbound transaction count and simple risk heuristics (ok, new_wallet, contract, eip7702).
  • Resolve NFT metadata for a contract address plus token ID: name, description, image URL, IPFS gateway link and raw metadata JSON, for ERC-721 and ERC-1155 tokens.
  • Both tools are read-only and return plain JSON; errors come back as normal tool errors.
When to use it
Useful when an assistant needs quick on-chain context about an Ethereum address or an NFT without signing up for an API key, for example checking whether an address is a contract or delegated EOA, or pulling an NFT's name and image link.
Requirements
Remote Streamable HTTP endpoint, nothing to install. An optional npm package runs the same tools over stdio and needs Node.js 20 or newer. No API key, signup or wallet connection. Optional variables GEXNO_API_BASE, GEXNO_TIMEOUT_MS and GEXNO_INTERNAL_TOKEN only matter for self-hosted instances.
Before you install
The free tier applies a short-burst rate limit and a daily cap per IP. Results are cached (wallet about 60 seconds, NFT metadata about 5 minutes). The risk field is a simple heuristic, not an AML or risk score, and should not be treated as one. Lookups go to the provider's API, so queried addresses are shared with that third party.

Installation

In SourceWeft

  1. Open Gexno Web3 in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.JanzenChen%2Fgexno-web3/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "gexno-web3": {
      "type": "http",
      "url": "https://api.gexno.com/mcp"
    }
  }
}

README

Gexno Web3 MCP

Free, no-signup on-chain lookups for AI agents. Two read-only tools: wallet profile and NFT metadata.

  • Remote: https://api.gexno.com/mcp — Streamable HTTP, nothing to install
  • npm: npx @gexno/web3-mcp — same tools over stdio
  • Registry name: io.github.JanzenChen/gexno-web3

No API key, no signup, no wallet connection. Reads only.

ToolWhat it returns
lookup_walletETH balance, contract flag, outbound tx count, simple risk heuristics (ok / new_wallet / contract / eip7702)
lookup_nftNFT metadata for contract + tokenId: name, description, image HTTP URL, IPFS gateway link, raw JSON (ERC-721 tokenURI and ERC-1155 uri)

Backed by the Gexno Web3 Agent API: https://api.gexno.com/api/web3

Use it (remote, nothing to install)

json
{  "mcpServers": {    "gexno-web3": {      "url": "https://api.gexno.com/mcp"    }  }}

Works with Claude Desktop, Cursor, and any MCP client that supports remote servers.

Discovery documents:

Use it (npm, stdio)

bash
npx -y @gexno/web3-mcp

Client config:

json
{  "mcpServers": {    "gexno-web3": {      "command": "npx",      "args": ["-y", "@gexno/web3-mcp"]    }  }}

Requires Node.js >= 20. The stdio process calls the same public HTTP API.

Environment variables

VariableDefaultPurpose
GEXNO_API_BASEhttps://api.gexno.comAPI root, useful for self-hosted instances
GEXNO_TIMEOUT_MS35000Per-request timeout; NFT + IPFS resolution can be slow
GEXNO_INTERNAL_TOKEN—Only for self-hosted Gexno APIs that require it. Never commit a value.

Programmatic use

js
import { TOOLS, createApiGet, runTool } from '@gexno/web3-mcp'
const apiGet = createApiGet({ apiBase: 'https://api.gexno.com' })const wallet = await runTool('lookup_wallet', { address: '0xd8dA...6045' }, apiGet)

Use it (local bundle, MCPB)

Download gexno-web3.mcpb from Releases and open it in Claude Desktop (drag onto the app, or Settings → Extensions).

What the output looks like

json
{  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",  "balanceEth": "5.7736",  "isContract": false,  "txCount": 5969,  "risk": "eip7702",  "eip7702": true,  "delegation": { "address": "0xd1ea…", "verified": true }}

EIP-7702 delegated EOAs are reported as risk: "eip7702" with isContract: false — they are still EOAs, they just carry a delegation designator. We parse the 0xef0100 prefix and checksum the delegate address, so a delegated wallet is not misreported as a smart contract.

Limits & behaviour

  • Free tier: short-burst rate limit plus a daily cap per IP; no key required.
  • Cached reads: wallet ~60s, NFT metadata ~5min. Repeat lookups are millisecond-scale.
  • No signup, no tracking, no wallet connection. Reads only.
  • Not an AML/risk score. Heuristics are intentionally simple.
  • Errors surface as normal MCP tool errors; the process does not crash.

Development

bash
npm installnpm run smoke    # live wallet lookup against the APInpm start        # run the stdio server directly

Test against a local API instead of production with GEXNO_API_BASE=http://127.0.0.1:3000.

Security posture and residual risks: HARDENING.md

Links

Source: README.md at commit 6b18695

Tools

2

lookup_wallet

Look up an Ethereum wallet

Look up an Ethereum wallet: ETH balance, contract flag, outbound tx count, and simple risk heuristics (ok / new_wallet / contract / eip7702). EIP-7702 delegated EOAs report risk=eip7702. Read-only; not an AML score.

Parametersaddressrequired

lookup_nft

Look up NFT metadata

Resolve NFT metadata for a contract + tokenId: name, description, image HTTP URL, IPFS gateway link, and raw metadata JSON. Supports ERC-721 and ERC-1155. Read-only.

ParameterstokenIdrequiredcontractrequired

Version history

1
  1. v0.1.3LatestOct 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Web3 integrations