eBird

liveScienceBiology

Cornell Lab bird sightings — 1B+ observations worldwide, with notable-sighting flags and rich region trees.

5tools
0msauth
free tier50 calls/day

Tools

recent_observationsrequired: region_code

Recent bird sightings in a region. region_code is the eBird identifier — countries are 2-letter ("US", "GB"), states "US-CA", counties "US-CA-075", and birding hotspots use the "L<id>" code from eBird

Parameters
NameTypeDescription
region_codereqstringeBird region code
species_codeoptstringOptional species filter
backoptnumber1-30 days
max_resultsoptnumber1-10000
include_provisionaloptbooleanInclude unconfirmed
▶Try it
recent_notablerequired: region_code

Only notable (rare / out-of-range / first-of-season) sightings in a region. Sometimes the most interesting subset.

Parameters
NameTypeDescription
region_codereqstringeBird region code
backoptnumber1-30 days
max_resultsoptnumber1-10000
detailoptstringsimple | full
▶Try it
nearby_observationsrequired: latitude, longitude

Recent BIRD sightings within a radius of a given latitude/longitude — eBird is a birds-only database and needs numeric lat/lon coordinates (not a place name). Useful for "what birds are around this lo

Parameters
NameTypeDescription
latitudereqnumberLatitude
longitudereqnumberLongitude
dist_kmoptnumber1-50
backoptnumber1-30 days
max_resultsoptnumber1-10000
species_codeoptstringOptional species filter
▶Try it
find_speciesrequired: query

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

Parameters
NameTypeDescription
queryreqstringSpecies name
▶Try it
list_subregionsrequired: region_type

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
NameTypeDescription
region_typereqstringcountry | subnational1 | subnational2
parent_region_codeoptstringParent region (default "world")
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/ebird/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/ebird/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"recent_observations","arguments":{"region_code": "example"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("recent_observations", {"region_code":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("cornell lab bird sightings — 1b+ observations worldwide, with notable-sighting flags and rich region trees");