Portal MCP Server

The Portal MCP server is experimental. Available tools and behavior may change.

Connect the Portal MCP server to your favorite AI coding clients. MCP (Model Context Protocol) is an open-source standard for connecting AI applications to external systems. The Portal MCP server gives your agent direct, structured access to blockchain data: discover datasets, query transactions and logs, analyze wallets, and compare chains — all from the same conversation. This is the fastest way to move from prompt to reliable onchain analysis across 225+ datasets.

Connect Portal MCP

MCP endpoint: https://portal.sqd.dev/mcp
Authentication: Free, no API keys required

Claude Code
Claude
Cursor
VS Code

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

Test the connection:

claude mcp list

See the Claude Code documentation for more details.

Custom connectors are available on all Claude plans. Free users are limited to one custom connector. For Team and Enterprise plans, only Owners can add connectors.

Add the Portal MCP server to Claude

Navigate to the Connectors page in Claude settings.
Select Add custom connector.
Add the Portal MCP server:
- Name: Portal
- URL: https://portal.sqd.dev/mcp
Select Add.

Access the MCP server in your chat

When using Claude, select the attachments button (the plus icon).
Select the Portal MCP server.
Ask Claude questions about blockchain data from Portal API.

See the Model Context Protocol documentation for more details.

Open MCP settings

Use Command + Shift + P (Ctrl + Shift + P on Windows) to open the command palette.
Search for “Open MCP settings”.
Select Add custom MCP. This opens the mcp.json file.

Configure the Portal MCP server

In mcp.json, add:

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

Test the connection

In Cursor’s chat, ask “What tools do you have available?” Cursor should show the Portal MCP server as an available tool.

See the Cursor documentation for more details.

Create a .vscode/mcp.json file and add:

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

See the VS Code documentation for more details.

Available tools

29 tools across EVM, Solana, Bitcoin, and Hyperliquid — all queryable in natural language.

Dataset Discovery

Tool	Description
`portal_list_datasets`	Search and filter available datasets
`portal_get_dataset_info`	Get dataset metadata, tables, and latest block

EVM Tools

Tool	Description
`portal_get_block_number`	Get latest or finalized block number
`portal_block_at_timestamp`	Convert Unix timestamp to block number
`portal_query_blocks`	Query block data with field presets
`portal_query_logs`	Query event logs with address/topic filters
`portal_query_transactions`	Query transactions (includes traces and state diffs via flags)
`portal_get_erc20_transfers`	Get ERC20 token transfers (auto-filters Transfer events)
`portal_decode_logs`	Decode event logs (Transfer, Swap, etc.)
`portal_get_recent_transactions`	Get recent transactions without manual block math
`portal_get_wallet_summary`	Wallet activity: transactions, tokens, NFTs
`portal_get_contract_activity`	Contract interaction count, callers, events
`portal_get_top_contracts`	Most active contracts by transaction count
`portal_get_transaction_density`	Transaction count per block
`portal_get_time_series`	Aggregate metrics over time intervals

Solana Tools

Tool	Description
`portal_query_solana_transactions`	Query transactions (includes balances, token balances, logs, rewards via flags)
`portal_query_solana_instructions`	Query program instructions with account filters
`portal_solana_analytics`	Transaction stats, program rankings, fee analysis
`portal_solana_time_series`	TPS, fee, and wallet trends over time

Bitcoin Tools

Tool	Description
`portal_query_bitcoin_transactions`	Query Bitcoin transactions
`portal_query_bitcoin_inputs`	Query transaction inputs (UTXO spending)
`portal_query_bitcoin_outputs`	Query transaction outputs (UTXO creation)
`portal_bitcoin_analytics`	Transaction stats, fee analysis, size distribution
`portal_bitcoin_time_series`	Block size, fees, and transaction trends over time

Hyperliquid Tools

Tool	Description
`portal_query_hyperliquid_fills`	Query trade fills with PnL, fees, routing
`portal_query_hyperliquid_replica_cmds`	Query orders, cancels, transfers, leverage updates
`portal_aggregate_hyperliquid_fills`	Volume, PnL, and trader stats by coin
`portal_hyperliquid_time_series`	Volume, trades, and unique traders over time
`portal_hyperliquid_analytics`	Trading volume, top coins, trader rankings

Known limitations

The MCP server may struggle with memory issues when handling large volumes of data, especially on high-TPS chains like Solana and Hyperliquid. v0.7.5 introduced chunked fetching and lower default limits to mitigate this, but large unfiltered queries can still cause timeouts or incomplete results. Always use filters and keep block ranges tight on dense chains.

Best practices

Use timeframes for any query — All query tools support the timeframe parameter (e.g., "24h", "7d") — no need to calculate block ranges manually
Try specialized tools first — Use high-level tools like portal_get_wallet_summary or portal_get_recent_transactions before lower-level query tools
Always filter queries — Use addresses, topics, or other filters to keep responses under the 50KB cap
Leverage analytics tools — Use per-chain analytics and time series tools to get summaries without fetching raw data
Mind block ranges — Keep queries under 10K blocks for logs, 5K for transactions, and 1K for traces for best performance. On high-TPS chains, use even smaller ranges

AI Development Overview — Resources for building AI agents with SQD
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

AI Development

MCP Servers

OpenAPI Schemas

Connect Portal MCP

Available tools

Dataset Discovery

EVM Tools

Solana Tools

Bitcoin Tools

Hyperliquid Tools

Known limitations

Best practices

AI Development

MCP Servers

OpenAPI Schemas

​Connect Portal MCP

​Available tools

​Dataset Discovery

​EVM Tools

​Solana Tools

​Bitcoin Tools

​Hyperliquid Tools

​Known limitations

​Best practices

​Related

Connect Portal MCP

Available tools

Dataset Discovery

EVM Tools

Solana Tools

Bitcoin Tools

Hyperliquid Tools

Known limitations

Best practices

Related