mcpField
M
mossgate-mcp

mossgate-mcp

Local
github.com/mossgatehqFinance0Updated 12w ago
Repository

About mossgate-mcp

mossgate-mcp is a stdio MCP server for agents that need token and wallet risk data or page rendering. Its four tools call paid Mossgate APIs, charging the operator’s funded USDC wallet on Base for each call.

Key features

  1. 01Token contract risk verdicts
  2. 02Wallet behavioral risk profiles
  3. 03Full token reports
  4. 04URL or HTML rendering to PDF, PNG, or JPEG
  5. 05Automatic x402 USDC payments on Base

Use cases

  1. 01Screen a token contract for risk
  2. 02Review a wallet’s behavioral risk
  3. 03Generate a document or image from a web page
  4. 04Provide paid API access to an MCP-enabled agent

MCP support

Exposes four tools to MCP clients over stdio: token and wallet checks plus page rendering. Each tool call pays through x402 using USDC on Base from the operator-funded wallet.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "dev-mossgate-mossgate": {
      "command": "npx",
      "args": [
        "-y",
        "mossgate-mcp"
      ],
      "env": {
        "MOSSGATE_BUYER_PK": "<MOSSGATE_BUYER_PK>"
      }
    }
  }
}
Run commandnpx -y mossgate-mcp
Environment variables to set
MOSSGATE_BUYER_PKSecretevm private key funding x402 usdc payments on base

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmossgate-mcp0.1.1

Tools

4

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
chainstringNochain name, default base
addressstringYesevm address, 0x-prefixed

Details

From the project README

mossgate-mcp

a model context protocol (mcp) stdio server that exposes two live paid apis to any mcp-enabled agent:

  • mossgate trust (https://api.mossgate.dev) token and wallet risk checks
  • rue render (https://rue.mossgate.dev) url/html to pdf/png/jpeg

payment is x402 v2, usdc on base. the operator who runs this server funds a wallet, and every tool call spends a little usdc from it. the wallet signs an eip-3009 authorization gaslessly, so it needs only usdc, no eth for gas.

tools

  • token_verdict(address, chain=base) quick risk verdict for a token contract
  • wallet_profile(address, chain=base) behavioural risk profile for a wallet
  • token_report(address, chain=base) full token report
  • render(url|html, format=pdf|png|jpeg) render a page, returns a base64 file

install

cd mcp-server
npm install

node 18+ is required.

fund the wallet

  1. create or reuse an evm wallet (any tool that gives a 0x private key).
  2. send it usdc on base (contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913). a few dollars covers many calls. no eth is needed, gas is sponsored by the facilitator.
  3. export the private key as an env var (never commit it):
export MOSSGATE_BUYER_PK=0xyourprivatekey

optional overrides: MOSSGATE_RPC (base rpc url), MOSSGATE_TRUST_URL, MOSSGATE_RENDER_URL.

run standalone

MOSSGATE_BUYER_PK=0x... node index.js

the server speaks mcp over stdio. it is meant to be launched by an mcp client, not used by hand.

claude desktop / mcp client config

add this to your mcp client config (for claude desktop: ~/.config/Claude/claude_desktop_config.json on linux, or ~/Library/Application Support/Claude/claude_desktop_config.json on macos):

{
    "mcpServers": {
        "mossgate": {
            "command": "node",
            "args": ["/absolute/path/to/products/mcp-server/index.js"],
            "env": {
                "MOSSGATE_BUYER_PK": "0xyourprivatekey"
            }
        }
    }
}

restart the client. the four tools appear and each call is paid automatically from the funded wallet.

verify it starts (no paid calls)

this lists the tools over stdio without touching the apis or spending anything:

printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
| node index.js

run without cloning

this package is on npm, so agents and clients can run it via npx with no clone or install. set the command to npx and args to ["-y", "mossgate-mcp"] in the client config:

{
    "mcpServers": {
        "mossgate": {
            "command": "npx",
            "args": ["-y", "mossgate-mcp"],
            "env": {
                "MOSSGATE_BUYER_PK": "0xyourprivatekey"
            }
        }
    }
}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.