`find_species`

Pack: ebird · 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/find_species for the schema, then POST the same URL with its arguments for the data.

Search the eBird taxonomy by common or scientific name. Returns the eBird species code needed by the observation tools.

Parameters

Name	Type	Required	Description
`query`	string	yes	Common or scientific name

Example call

Arguments

{
  "query": "Great Blue Heron"
}

curl

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":"find_species","arguments":{"query":"Great Blue Heron"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('find_species', {
  "query": "Great Blue Heron"
});

More examples

{
  "query": "Ardea herodias"
}

Response shape

Always returns: query, count, species

Field	Type	Description
`query`	string	Search query string
`count`	number	Number of species results
`species`	array	List of matching species

Full JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query string"
    },
    "count": {
      "type": "number",
      "description": "Number of species results"
    },
    "species": {
      "type": "array",
      "description": "List of matching species",
      "items": {
        "type": "object",
        "properties": {
          "species_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "eBird species code"
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Species common or scientific name"
          }
        },
        "required": []
      }
    }
  },
  "required": [
    "query",
    "count",
    "species"
  ]
}

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 ebird pack

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

See Getting Started for client-specific install steps.

find_species