@hop.ag/mcp-server

MCP server for LLM agents to quote swaps, search tokens, and build unsigned Sui transactions with the @hop.ag/sdk.

hop.ag · GitHub · Telegram Channel

Hop Hosted MCP server
https://mcp.hop.ag/v1/

This package supports two transports:

• Local stdio for clients that launch MCP servers as local processes.
• Remote Streamable HTTP for hosted deployments

The server never signs or submits transactions. Transaction-building tools return unsigned transaction data for review and signing by the caller.

Remote MCP

Use this URL when connecting a remote MCP client:

https://mcp.hop.ag/v1/

Health check:

https://mcp.hop.ag/health

Example OpenAI Responses API tool configuration:

{
  "type": "mcp",
  "server_label": "hop",
  "server_description": "Hop tools for Sui token quotes, prices, token discovery, and unsigned transaction building.",
  "server_url": "https://mcp.hop.ag/v1/",
  "require_approval": "always"
}

Example Claude remote connector URL:

https://mcp.hop.ag/v1/

Some ChatGPT connector flows expect search and fetch tools for deep research style connectors. Full MCP/developer-mode clients can use the Hop-specific tools directly.

Local Usage

From the repo root:

npm install
npm run sdk:build
npm run mcp:build

Run the local stdio server:

npm exec -w @hop.ag/mcp-server hop-mcp-server

Or during development:

npm run mcp:dev

Example local MCP config:

{
  "mcpServers": {
    "hop": {
      "command": "npm",
      "args": ["exec", "-w", "@hop.ag/mcp-server", "hop-mcp-server"],
      "cwd": "/path/to/router3",
      "env": {
        "SUI_RPC_URL": "https://fullnode.mainnet.sui.io:443"
      }
    }
  }
}

Configuration

The server reads these optional environment variables:

Variable	Description
HOP_API_BASE_URL	Hop API base URL. Defaults to the SDK default.
SUI_RPC_URL	Server-side Sui RPC URL used for transaction building and simulation. This is not exposed as an LLM tool argument.
HOP_FEE_BPS	Optional integrator fee in basis points.
HOP_FEE_ADDRESS	Required when HOP_FEE_BPS is non-zero.
HOP_SPONSORED_TX	Set to true for sponsored transaction mode.
PORT	HTTP server port. Defaults to 3002.
HOST	HTTP bind host. Defaults to 0.0.0.0.
MCP_PATH	HTTP MCP path. Defaults to /v1/.
MCP_ALLOWED_HOSTS	Comma-separated hostnames allowed by host-header validation.
MCP_ICON_URL	Icon URL returned in MCP server metadata. Defaults to the Hop logo.

Tools

Tool	Purpose
hop_quote	Get a Hop swap quote for a Sui token pair.
hop_get_price	Get a token price in SUI and USDC terms.
hop_search_tokens	Search Hop token metadata.
hop_verified_tokens	List verified Hop tokens.
hop_build_swap_transaction	Build an unsigned swap transaction from a fresh quote.
hop_publish_launch_coin_transaction	Build an unsigned Hop Launch coin publish transaction.
hop_create_launch_coin_transaction	Build an unsigned Hop Launch curve creation transaction.
hop_simulate_transaction	Simulate a serialized Hop transaction with Sui devInspect.
hop_supported_exchanges	List exchange provider names accepted by exclude_providers.
hop_common_constants	Return common SDK coin constants and endpoints.

Security

• The server does not store private keys.
• The server does not sign transactions.
• The server does not submit transactions.
• Hosted deployments should avoid logging full tool arguments by default.
• Hosted deployments should rate limit public traffic.
• Users should review unsigned transaction output before signing.