{"id":29885832,"url":"https://github.com/moonbirdai/ebird-mcp-server","last_synced_at":"2026-06-29T13:32:07.850Z","repository":{"id":291166447,"uuid":"976809451","full_name":"moonbirdai/ebird-mcp-server","owner":"moonbirdai","description":"A Model Context Protocol (MCP) server for the eBird API, allowing Claude and other AI assistants to access bird observation data, hotspots, and taxonomy information. Easy integration with Claude Desktop.","archived":false,"fork":false,"pushed_at":"2025-05-02T19:53:46.000Z","size":15,"stargazers_count":1,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-31T18:01:36.881Z","etag":null,"topics":["birdwatching","claude-desktop","ebird","model-context-protocol","model-context-protocol-servers","ornithology"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moonbirdai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-02T19:42:12.000Z","updated_at":"2025-06-26T18:33:46.000Z","dependencies_parsed_at":"2025-05-02T20:42:03.001Z","dependency_job_id":null,"html_url":"https://github.com/moonbirdai/ebird-mcp-server","commit_stats":null,"previous_names":["moonbirdai/ebird-mcp-server"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/moonbirdai/ebird-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moonbirdai%2Febird-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moonbirdai%2Febird-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moonbirdai%2Febird-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moonbirdai%2Febird-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moonbirdai","download_url":"https://codeload.github.com/moonbirdai/ebird-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moonbirdai%2Febird-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34929698,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-29T02:00:05.398Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["birdwatching","claude-desktop","ebird","model-context-protocol","model-context-protocol-servers","ornithology"],"created_at":"2025-07-31T16:02:55.221Z","updated_at":"2026-06-29T13:32:07.844Z","avatar_url":"https://github.com/moonbirdai.png","language":"JavaScript","funding_links":[],"categories":["Other Tools and Integrations","🌐 Web Development"],"sub_categories":["How to Submit"],"readme":"# eBird MCP Server\n\nA Model Context Protocol (MCP) server for integrating with the eBird API. This server allows AI assistants, like Claude, to access bird observation data, hotspots, and taxonomy information from eBird.\n\n## Quick Setup for Claude Desktop\n\nAdd this configuration to your Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"ebird-api\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"ebird-mcp-server\",\n        \"--api-key\",\n        \"YOUR_EBIRD_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\nMake sure to:\n1. Replace `YOUR_EBIRD_API_KEY` with your actual eBird API key\n2. Create the config file if it doesn't exist\n3. Install the package globally with `npm install -g ebird-mcp-server` if you haven't already\n4. Restart Claude Desktop after saving the changes\n\n\u003e **Note**: You can get an eBird API key from [eBird API Key Request](https://ebird.org/api/keygen)\n\n## Features\n\nThe eBird MCP server provides access to the following eBird data:\n\n- Recent bird observations in a region\n- Recent observations of specific bird species\n- Notable bird observations in a region\n- Observations near a location\n- Notable observations near a location\n- Birding hotspots in a region\n- Hotspots near a location\n- eBird taxonomy information\n\n## Prerequisites\n\n- Node.js (v14 or later)\n- An eBird API key (get one from [eBird API Key Request](https://ebird.org/api/keygen))\n\n## Installation\n\n### For Claude Desktop\n\n1. Clone this repository or download the files\n2. Run the Claude Desktop setup script:\n\n```bash\nchmod +x claude_setup.sh\n./claude_setup.sh YOUR_EBIRD_API_KEY\n```\n\n3. Restart Claude Desktop\n\n### For Other MCP Clients\n\n1. Clone this repository or download the files\n2. Run the installation script:\n\n```bash\nchmod +x install.sh\n./install.sh YOUR_EBIRD_API_KEY\n```\n\n3. The server is now installed and can be run with:\n\n```bash\n./run-ebird-mcp-server.sh\n```\n\n### Manual Installation\n\n1. Clone this repository or download the files\n2. Install dependencies:\n\n```bash\nnpm install\n```\n\n3. Run the server:\n\n```bash\nnode index.js --api-key YOUR_EBIRD_API_KEY\n```\n\n## Available Tools\n\n### ebird_get_recent_observations\n\nGet recent bird observations in a region or location.\n\n**Parameters:**\n- `regionCode` (required): Region code (e.g., US, US-NY, L123456)\n- `back`: Number of days back to look for observations (default: 14)\n- `maxResults`: Maximum number of results to return (default: 100)\n- `includeProvisional`: Include provisional observations (default: true)\n- `hotspot`: Only include observations from hotspots (default: false)\n- `detail`: Detail level of results ('simple' or 'full', default: 'simple')\n\n### ebird_get_recent_observations_for_species\n\nGet recent observations of a specific bird species in a region.\n\n**Parameters:**\n- `regionCode` (required): Region code (e.g., US, US-NY, L123456)\n- `speciesCode` (required): eBird species code (e.g., amecro for American Crow)\n- `back`: Number of days back to look for observations (default: 14)\n- `maxResults`: Maximum number of results to return (default: 100)\n- `includeProvisional`: Include provisional observations (default: true)\n- `hotspot`: Only include observations from hotspots (default: false)\n\n### ebird_get_notable_observations\n\nGet notable bird observations in a region.\n\n**Parameters:**\n- `regionCode` (required): Region code (e.g., US, US-NY, L123456)\n- `back`: Number of days back to look for observations (default: 14)\n- `maxResults`: Maximum number of results to return (default: 100)\n- `detail`: Detail level of results ('simple' or 'full', default: 'simple')\n\n### ebird_get_nearby_observations\n\nGet recent bird observations near a location.\n\n**Parameters:**\n- `lat` (required): Latitude coordinate\n- `lng` (required): Longitude coordinate\n- `dist`: Distance in kilometers from lat/lng point (default: 25)\n- `back`: Number of days back to look for observations (default: 14)\n- `maxResults`: Maximum number of results to return (default: 100)\n- `includeProvisional`: Include provisional observations (default: true)\n- `hotspot`: Only include observations from hotspots (default: false)\n- `detail`: Detail level of results ('simple' or 'full', default: 'simple')\n\n### ebird_get_nearby_notable_observations\n\nGet notable bird observations near a location.\n\n**Parameters:**\n- `lat` (required): Latitude coordinate\n- `lng` (required): Longitude coordinate\n- `dist`: Distance in kilometers from lat/lng point (default: 25)\n- `back`: Number of days back to look for observations (default: 14)\n- `maxResults`: Maximum number of results to return (default: 100)\n- `detail`: Detail level of results ('simple' or 'full', default: 'simple')\n\n### ebird_get_nearby_observations_for_species\n\nGet recent observations of a specific bird species near a location.\n\n**Parameters:**\n- `lat` (required): Latitude coordinate\n- `lng` (required): Longitude coordinate\n- `speciesCode` (required): eBird species code (e.g., amecro for American Crow)\n- `dist`: Distance in kilometers from lat/lng point (default: 25)\n- `back`: Number of days back to look for observations (default: 14)\n- `maxResults`: Maximum number of results to return (default: 100)\n- `includeProvisional`: Include provisional observations (default: true)\n\n### ebird_get_hotspots\n\nGet birding hotspots in a region.\n\n**Parameters:**\n- `regionCode` (required): Region code (e.g., US, US-NY)\n- `back`: Number of days back to look for hotspot activity (default: 14)\n- `includeProvisional`: Include provisional observations (default: true)\n\n### ebird_get_nearby_hotspots\n\nGet birding hotspots near a location.\n\n**Parameters:**\n- `lat` (required): Latitude coordinate\n- `lng` (required): Longitude coordinate\n- `dist`: Distance in kilometers from lat/lng point (default: 25)\n- `back`: Number of days back to look for hotspot activity (default: 14)\n- `includeProvisional`: Include provisional observations (default: true)\n\n### ebird_get_taxonomy\n\nGet eBird taxonomy information.\n\n**Parameters:**\n- `locale`: Language for common names (default: 'en')\n- `cat`: Taxonomic category to filter by (default: 'species')\n- `fmt`: Response format (default: 'json')\n\n### ebird_get_taxonomy_forms\n\nGet eBird taxonomy forms for a specific species.\n\n**Parameters:**\n- `speciesCode` (required): eBird species code\n\n## Testing\n\nTo test the eBird MCP server, set your eBird API key as an environment variable and run the test script:\n\n```bash\nexport EBIRD_API_KEY=your_api_key\nnode test-ebird.js\n```\n\n## Debug Mode\n\nTo enable debug mode and see detailed logging:\n\n```bash\nnode index.js --api-key YOUR_EBIRD_API_KEY --debug\n```\n\n## License\n\nMIT\n\n## Acknowledgements\n\n- [eBird](https://ebird.org/) for providing the API\n- [Cornell Lab of Ornithology](https://www.birds.cornell.edu/) for their work on bird conservation\n- [Model Context Protocol](https://modelcontextprotocol.io/) for the API integration framework","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoonbirdai%2Febird-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoonbirdai%2Febird-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoonbirdai%2Febird-mcp-server/lists"}