Skip to main content
The Webacy API exposes an MCP (Model Context Protocol) server that lets AI coding assistants like Claude Code and Cursor query blockchain risk data directly from your development environment. Instead of switching to a browser or writing API calls manually, you can ask your AI assistant questions like “Analyze the risk of 0x742d…” and get real-time results inline.

​
Prerequisites

Keep your API key secret. Never commit it to version control.

​
Installation

​
Claude Code

Add the Webacy MCP server using the CLI: 
claude mcp add webacy-mcp --transport http https://api.webacy.com/mcp --header "x-api-key: YOUR_API_KEY"
Or add it manually to your .claude/mcp.json file: 
{
  "mcpServers": {
    "webacy-mcp": {
      "type": "http",
      "url": "https://api.webacy.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

​
Cursor

Open Cursor Settings and navigate to MCP Servers. Click Add Server and configure: 
{
  "mcpServers": {
    "webacy-mcp": {
      "url": "https://api.webacy.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

​
Other MCP Clients

Any MCP client that supports HTTP Streamable transport can connect to the Webacy MCP server. Use the following configuration:
SettingValue
URLhttps://api.webacy.com/mcp
TransportHTTP Streamable
Auth Headerx-api-key: YOUR_API_KEY

​
Available Tools

The MCP server exposes three tools for blockchain risk analysis:

​
get_address_risk

Analyze the risk profile of a blockchain address (wallet or contract). Returns risk score, risk factors, and detailed security analysis.
ParameterTypeRequiredDescription
addressstringYesThe blockchain address to analyze
chainstringYesBlockchain network (e.g. eth, sol, base)
detailed_responsebooleanNoInclude detailed risk factor breakdowns
show_low_riskbooleanNoInclude low-risk factors in the response
modulesstring[]NoSpecific risk analysis modules to run

​
get_token_risk

Analyze the risk profile of a token contract. Returns token security flags, market data, and economic risk indicators.
ParameterTypeRequiredDescription
addressstringYesThe token contract address to analyze
chainstringYesBlockchain network (e.g. eth, sol, base)
metrics_datestringNoDate for historical metrics (DD-MM-YYYY format)
modulesstring[]NoSpecific risk analysis modules to run

​
get_holder_analysis

Analyze the holder distribution and concentration of a token. Returns top holders, holder counts, and distribution metrics.
ParameterTypeRequiredDescription
addressstringYesThe token contract address to analyze
chainstringNoBlockchain network (defaults to sol)
disable_refetchbooleanNoSkip re-fetching data and use existing data only
refresh_cachebooleanNoForce refresh cached holder data

​
Supported Chains

The chain parameter accepts: eth, sol, arb, pol, opt, base, bsc, ton, sui, stellar, btc, sei, hedera.
See Supported Blockchains for full details on each chain.

​
Example Usage

Once configured, you can query Webacy risk data directly from your AI assistant: 
You:    Analyze the risk of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on Ethereum

Claude: I'll check the risk profile using the Webacy MCP tools...

        The address has an overall risk score of 25.99/100 (low risk).
        No high-severity issues were found. The address is an EOA (not a contract).
You can also analyze tokens and holder distributions: 
You:    What's the token risk for USDC on Ethereum (0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48)?

You:    Show me the holder analysis for this Solana token: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

​
Next Steps

API Reference

Explore all available endpoints

SDK

Use the TypeScript SDK for programmatic access

Risk Levels

Understand how to interpret risk scores