Portal API MCP Server

​

Access the Portal MCP server

​

Use the Portal MCP server

claude mcp add --transport http Portal https://portal.sqd.workers.dev/mcp

claude mcp list

{
  "mcpServers": {
    "Portal": {
      "url": "https://portal.sqd.workers.dev/mcp"
    }
  }
}

{
  "servers": {
    "Portal": {
      "type": "http",
      "url": "https://portal.sqd.workers.dev/mcp"
    }
  }
}

​

Available tools

​

Information & Discovery (3 tools)

• portal_get_sqd_info - Get SQD Network overview and supported chains
• portal_get_capabilities - List available query types and Portal API features
• portal_suggest_tool - AI-powered tool recommendation for your query

​

Dataset Management (3 tools)

• portal_list_datasets - Browse all available blockchain datasets
• portal_search_datasets - Find datasets by name, alias, or pattern
• portal_get_dataset_info - Get detailed metadata and block ranges for a dataset

​

Core Data Queries (10 tools)

• portal_query_logs - Query event logs from smart contracts (supports timeframes)
• portal_query_transactions - Query blockchain transactions (supports timeframes)
• portal_query_traces - Query internal transactions and contract deployments
• portal_query_blocks - Query block data
• portal_query_state_diffs - Query storage state changes

• portal_query_solana_instructions - Query program instructions with discriminator filters
• portal_query_solana_balances - Query SOL balance changes
• portal_query_solana_token_balances - Query SPL token balance changes
• portal_query_solana_logs - Query program log messages
• portal_query_solana_rewards - Query block rewards

​

Token & Transfer Tools (4 tools)

• portal_get_erc20_transfers - Get ERC20 token transfers (easier than querying logs)
• portal_get_nft_transfers - Get NFT transfers (ERC721/ERC1155)
• portal_get_token_info - Get token metadata from CoinGecko (name, symbol, logo)
• portal_aggregate_transfers - Get transfer statistics without fetching all records

​

Analytics & Insights (9 tools)

• portal_get_wallet_summary - Complete wallet activity (transactions + tokens + NFTs)
• portal_get_recent_transactions - Recent transactions without manual block calculation
• portal_get_transaction_density - Transaction count per block for charts
• portal_get_gas_analytics - Gas price trends and optimization insights
• portal_get_time_series - Time-bucketed metrics for trend analysis
• portal_get_contract_activity - Contract usage statistics and top callers
• portal_get_contract_deployments - Recent contract deployments on a chain
• portal_get_top_contracts - Most active contracts by transaction volume
• portal_get_top_addresses - Most active wallet addresses
• portal_count_events - Count events without fetching full data

​

Multi-Chain & Advanced (6 tools)

• portal_batch_query - Execute same query across multiple chains in parallel
• portal_compare_chains - Compare metrics across chains (activity, gas, etc.)
• portal_resolve_addresses - Resolve addresses to human-readable labels
• portal_block_at_timestamp - Find block number at specific timestamp (EVM)
• portal_decode_logs - Decode event logs using known signatures
• portal_query_paginated - Execute paginated queries for large block ranges

​

Low-Level Tools (1 tool)

• portal_stream - Execute custom low-level Portal API queries (advanced users)

​

Best practices

1. Use timeframes for recent data - Tools like portal_query_logs and portal_query_transactions support timeframe parameters (e.g., “24h”, “7d”) for easier queries
2. Try specialized tools first - Use high-level tools like portal_get_wallet_summary or portal_get_recent_transactions before lower-level query tools
3. Use portal_suggest_tool - Ask this tool which Portal tool to use for your specific question
4. Always filter queries - Use addresses, topics, or other filters to avoid memory limits
5. Leverage analytics tools - Use portal_count_events, portal_aggregate_transfers, or portal_get_transaction_density to get summaries without fetching all data
6. Batch multi-chain queries - Use portal_batch_query or portal_compare_chains to query multiple chains in parallel

​

Related

• AI Agent Guide - Decision framework for selecting tools
• Portal API Reference - HTTP API for blockchain data
• Documentation MCP Server - Search SQD documentation
• Pipes SDK - TypeScript SDK for custom pipelines
• llms.txt - Documentation index for LLMs