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

​

Dataset Management (5 tools)

• portal_list_datasets - Browse accessible blockchain datasets
• portal_search_datasets - Locate chains by name or criteria
• portal_get_dataset_info - Retrieve metadata and block ranges
• portal_get_block_number - Obtain current block height
• portal_validate_dataset - Verify dataset existence with suggestions

​

EVM Queries (8 tools)

• portal_query_blocks - Access block details and transactions
• portal_query_logs - Retrieve smart contract events
• portal_query_transactions - Examine transaction information
• portal_get_transactions_by_date - Query transactions using a specific date
• portal_query_traces - Investigate internal calls
• portal_query_state_diffs - Monitor storage modifications
• portal_get_erc20_transfers - Follow token movements
• portal_get_nft_transfers - Track NFT activity

​

Solana Queries (5 tools)

• portal_query_solana_instructions - Examine program execution
• portal_query_solana_balances - Monitor SOL movements
• portal_query_solana_token_balances - Track SPL holdings
• portal_query_solana_logs - Access program messages
• portal_query_solana_rewards - Analyze validator incentives

​

Time-Range Queries (2 tools)

• portal_query_by_custom_dates - Calendar-based queries
• portal_query_by_date_range - Predefined time windows

​

Advanced Features (7 tools)

• portal_stream - Custom low-level data access
• portal_query_paginated - Handle large datasets with cursor-based pagination
• portal_block_at_timestamp - Convert time to block numbers
• portal_batch_query - Parallel multi-chain operations
• portal_decode_logs - Parse events using ABI
• portal_get_address_activity - Comprehensive wallet analysis
• portal_get_token_transfers_for_address - Track holdings

​

Best practices

1. Retrieve current block height before querying to establish valid ranges
2. Always filter queries by addresses or topics to avoid memory limits
3. Keep date ranges narrow (1-2 days maximum for logs/transactions)
4. Leverage pagination for results exceeding single-request limits
5. Batch operations across multiple blockchains simultaneously

​

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