get_recent_checklists
Retrieve recently submitted bird observation checklists for a specified region using eBird data, helping users track recent birding activity and sightings.
Instructions
Get the most recently submitted checklists for a region.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region_code | Yes | Country, subnational1, subnational2, or location code | |
| max_results | No | Number of checklists to return |
Implementation Reference
- src/index.ts:314-317 (handler)The inline handler function that fetches recent checklists from the eBird API using makeRequest and returns the result as formatted JSON content.
async (args) => { const result = await makeRequest(`/product/lists/${args.region_code}`, { maxResults: args.max_results }); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; } - src/index.ts:310-313 (schema)Zod input schema defining parameters for region_code and optional max_results.
{ region_code: z.string().describe("Country, subnational1, subnational2, or location code"), max_results: z.number().min(1).max(200).default(10).describe("Number of checklists to return"), }, - src/index.ts:307-318 (registration)MCP server.tool registration call for the get_recent_checklists tool, including name, description, schema, and handler.
server.tool( "get_recent_checklists", "Get the most recently submitted checklists for a region.", { region_code: z.string().describe("Country, subnational1, subnational2, or location code"), max_results: z.number().min(1).max(200).default(10).describe("Number of checklists to return"), }, async (args) => { const result = await makeRequest(`/product/lists/${args.region_code}`, { maxResults: args.max_results }); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; } );