`get_chain`

Pack: chainlist · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_chain for the schema, then POST the same URL with its arguments for the data.

Fetch a single chain by chainId (number) or shortName (e.g. “eth”, “matic”, “arb1”).

Parameters

Name	Type	Required	Description
`chain_id_or_short_name`	string	yes	Chain id as string or shortName

Example call

Arguments

{
  "chain_id_or_short_name": "eth"
}

curl

curl -X POST https://gateway.pipeworx.io/chainlist/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_chain","arguments":{"chain_id_or_short_name":"eth"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_chain', {
  "chain_id_or_short_name": "eth"
});

More examples

{
  "chain_id_or_short_name": "1"
}

Response shape

Always returns: name, chain, shortName, chainId

Field	Type	Description
`name`	string	Chain name
`chain`	string	Chain identifier
`shortName`	string	Short chain name
`chainId`	integer	EVM chain ID
`networkId`	integer	Network ID (optional)
`nativeCurrency`	object	Native currency details
`rpc`	array	RPC endpoint URLs
`explorers`	array	Block explorers
`faucets`	array	Faucet URLs for testnet tokens
`infoURL`	string	Chain information URL (optional)
`status`	string	Chain status (active, deprecated, incubating)

Full JSON Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Chain name"
    },
    "chain": {
      "type": "string",
      "description": "Chain identifier"
    },
    "shortName": {
      "type": "string",
      "description": "Short chain name"
    },
    "chainId": {
      "type": "integer",
      "description": "EVM chain ID"
    },
    "networkId": {
      "type": "integer",
      "description": "Network ID (optional)"
    },
    "nativeCurrency": {
      "type": "object",
      "description": "Native currency details",
      "properties": {
        "name": {
          "type": "string",
          "description": "Currency name"
        },
        "symbol": {
          "type": "string",
          "description": "Currency symbol"
        },
        "decimals": {
          "type": "integer",
          "description": "Number of decimals"
        }
      }
    },
    "rpc": {
      "type": "array",
      "description": "RPC endpoint URLs",
      "items": {
        "type": "string"
      }
    },
    "explorers": {
      "type": "array",
      "description": "Block explorers",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Explorer name"
          },
          "url": {
            "type": "string",
            "description": "Explorer URL"
          },
          "standard": {
            "type": "string",
            "description": "Standard type (optional)"
          }
        }
      }
    },
    "faucets": {
      "type": "array",
      "description": "Faucet URLs for testnet tokens",
      "items": {
        "type": "string"
      }
    },
    "infoURL": {
      "type": "string",
      "description": "Chain information URL (optional)"
    },
    "status": {
      "type": "string",
      "description": "Chain status (active, deprecated, incubating)"
    }
  },
  "required": [
    "name",
    "chain",
    "shortName",
    "chainId"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the chainlist pack

{
  "mcpServers": {
    "chainlist": {
      "url": "https://gateway.pipeworx.io/chainlist/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_chain