MCP Server - AI Agent Integration

Official MCP RegistrynpmSmitheryCline Marketplace

What is the Guava MCP Server?

The Model Context Protocol (MCP) is an open standard that lets AI assistants like Claude, Cursor, Windsurf, and other MCP-compatible clients call external tools. Guava's MCP server exposes our crypto security API as MCP tools, so AI agents can check honeypot risk, analyze wallets, and list supported chains without leaving the conversation.

This is the same integration strategy used by GoPlus Security, which powers AI-powered crypto analysis in major wallets and exchanges.

Installation

Remote Server (Recommended)

The Guava MCP server is hosted remotely at https://api.guavaintel.com/mcp. No local installation needed. Just add the URL and your API key to your MCP client config. Get your API key at API Access.

Two Authentication Options

API Key — Add X-API-Key header. Works with any MCP client.
OAuth 2.1 — Browser login + consent flow (PKCE). For interactive clients like Cursor and Devin.

Install in Windsurf

Claude Desktop

Add the Guava MCP server to your Claude Desktop config file:

Config location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "guava": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.guavaintel.com/mcp",
        "--header",
        "X-API-Key: gw_your_api_key_here"
      ]
    }
  }
}

Cursor

Add to Cursor's MCP settings (Settings > Features > MCP):

{
  "mcpServers": {
    "guava": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.guavaintel.com/mcp",
        "--header",
        "X-API-Key: gw_your_api_key_here"
      ]
    }
  }
}

Windsurf / Devin

For Windsurf or Devin, use this MCP server configuration:

{
  "mcpServers": {
    "guava": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.guavaintel.com/mcp",
        "--header",
        "X-API-Key: gw_your_api_key_here"
      ]
    }
  }
}

Local Server (Alternative)

Install the npm package globally:

npm install -g @guavawalletintelligence/mcp-server

Then use this config instead of the remote URL:

{
  "mcpServers": {
    "guava": {
      "command": "guava-mcp-server",
      "env": {
        "GUAVA_API_KEY": "gw_your_api_key_here",
        "GUAVA_API_URL": "https://api.guavaintel.com"
      }
    }
  }
}

Smithery

Install directly from Smithery:

npx -y @smithery/cli install guava/wallet-intelligence

Smithery handles the gateway and API key injection automatically.

Available Tools

check_token_security

Check if a token is a honeypot or has security risks. Returns honeypot status, risk score, buy/sell tax, contract verification, and owner privileges.

Parameters

Name	Type	Description
chain	string	Blockchain ID (ethereum, solana, bsc, base, etc.)
contract	string	Token contract address

Returns

Token security report with risk score, honeypot status, and security flags

analyze_wallet

Analyze a wallet's risk profile, transaction history, and token holdings.

Parameters

Name	Type	Description
chain	string	Blockchain ID
address	string	Wallet address

Returns

Wallet analysis with risk score, balance, transactions, and flags

list_chains

List all 31 supported blockchains including Ethereum, Solana, BSC, Base, Arbitrum, Polygon, Optimism, and more.

No parameters required.

Returns

Array of supported chain IDs and names

Example Usage in Claude

Ask Claude:

"Check if the token at 0x6982508145454Ce325dDbE47a25d4ec3d2311933
on Ethereum is a honeypot using Guava."

Claude will call:

check_token_security({
  chain: "ethereum",
  contract: "0x6982508145454Ce325dDbE47a25d4ec3d2311933"
})

Claude responds with:

Token: PEPE (Ethereum)
Risk Score: 8/100 (Low)
Honeypot: No
Buy Tax: 0%
Sell Tax: 0%
Open Source: Yes
Not Mintable: Yes
No Hidden Owner: Yes

This token appears safe based on 30+ security checks.

Available On

MCP Registry

Official registry by MCP

Smithery

10k+ MCP users

npm

@guavawalletintelligence/mcp-server

Website

guavaintel.com

Get Your API Key

You need a Guava API key to use the MCP server. Free tier includes 10 requests per day.

Get API Key API Reference