list_subregions

Pack: ebird · Endpoint: https://gateway.pipeworx.io/ebird/mcp

Child regions of a parent. region_type is “country”, “subnational1” (states/provinces), or “subnational2” (counties). parent_region_code uses eBird codes (“world”, “US”, “US-CA”).

Parameters

NameTypeRequiredDescription
region_typestringyescountry | subnational1 | subnational2
parent_region_codestringnoParent region (default “world”)

Example call

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

Response shape

Always returns: region_type, parent_region, count, regions

FieldTypeDescription
region_typestringRegion type requested (country, subnational1, subnational2)
parent_regionstringParent region code
countnumberNumber of subregions returned
regionsarrayList of child regions
Full JSON Schema
{
  "type": "object",
  "properties": {
    "region_type": {
      "type": "string",
      "description": "Region type requested (country, subnational1, subnational2)"
    },
    "parent_region": {
      "type": "string",
      "description": "Parent region code"
    },
    "count": {
      "type": "number",
      "description": "Number of subregions returned"
    },
    "regions": {
      "type": "array",
      "description": "List of child regions",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Region code"
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Region name"
          }
        },
        "required": []
      }
    }
  },
  "required": [
    "region_type",
    "parent_region",
    "count",
    "regions"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

Regenerated from source · build May 21, 2026