eBird MCP Server

by moonbirdai

Integrations

  • Required runtime environment for the eBird MCP server, enabling the server to process requests and interact with the eBird API.

  • Used to install and run the eBird MCP server package, facilitating easy setup and deployment.

eBird MCP Server

A 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.

Quick Setup for Claude Desktop

Add this configuration to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "ebird-api": { "command": "npx", "args": [ "ebird-mcp-server", "--api-key", "YOUR_EBIRD_API_KEY" ] } } }

Make sure to:

  1. Replace YOUR_EBIRD_API_KEY with your actual eBird API key
  2. Create the config file if it doesn't exist
  3. Install the package globally with npm install -g ebird-mcp-server if you haven't already
  4. Restart Claude Desktop after saving the changes

Note: You can get an eBird API key from eBird API Key Request

Features

The eBird MCP server provides access to the following eBird data:

  • Recent bird observations in a region
  • Recent observations of specific bird species
  • Notable bird observations in a region
  • Observations near a location
  • Notable observations near a location
  • Birding hotspots in a region
  • Hotspots near a location
  • eBird taxonomy information

Prerequisites

Installation

For Claude Desktop

  1. Clone this repository or download the files
  2. Run the Claude Desktop setup script:
chmod +x claude_setup.sh ./claude_setup.sh YOUR_EBIRD_API_KEY
  1. Restart Claude Desktop

For Other MCP Clients

  1. Clone this repository or download the files
  2. Run the installation script:
chmod +x install.sh ./install.sh YOUR_EBIRD_API_KEY
  1. The server is now installed and can be run with:
./run-ebird-mcp-server.sh

Manual Installation

  1. Clone this repository or download the files
  2. Install dependencies:
npm install
  1. Run the server:
node index.js --api-key YOUR_EBIRD_API_KEY

Available Tools

ebird_get_recent_observations

Get recent bird observations in a region or location.

Parameters:

  • regionCode (required): Region code (e.g., US, US-NY, L123456)
  • back: Number of days back to look for observations (default: 14)
  • maxResults: Maximum number of results to return (default: 100)
  • includeProvisional: Include provisional observations (default: true)
  • hotspot: Only include observations from hotspots (default: false)
  • detail: Detail level of results ('simple' or 'full', default: 'simple')

ebird_get_recent_observations_for_species

Get recent observations of a specific bird species in a region.

Parameters:

  • regionCode (required): Region code (e.g., US, US-NY, L123456)
  • speciesCode (required): eBird species code (e.g., amecro for American Crow)
  • back: Number of days back to look for observations (default: 14)
  • maxResults: Maximum number of results to return (default: 100)
  • includeProvisional: Include provisional observations (default: true)
  • hotspot: Only include observations from hotspots (default: false)

ebird_get_notable_observations

Get notable bird observations in a region.

Parameters:

  • regionCode (required): Region code (e.g., US, US-NY, L123456)
  • back: Number of days back to look for observations (default: 14)
  • maxResults: Maximum number of results to return (default: 100)
  • detail: Detail level of results ('simple' or 'full', default: 'simple')

ebird_get_nearby_observations

Get recent bird observations near a location.

Parameters:

  • lat (required): Latitude coordinate
  • lng (required): Longitude coordinate
  • dist: Distance in kilometers from lat/lng point (default: 25)
  • back: Number of days back to look for observations (default: 14)
  • maxResults: Maximum number of results to return (default: 100)
  • includeProvisional: Include provisional observations (default: true)
  • hotspot: Only include observations from hotspots (default: false)
  • detail: Detail level of results ('simple' or 'full', default: 'simple')

ebird_get_nearby_notable_observations

Get notable bird observations near a location.

Parameters:

  • lat (required): Latitude coordinate
  • lng (required): Longitude coordinate
  • dist: Distance in kilometers from lat/lng point (default: 25)
  • back: Number of days back to look for observations (default: 14)
  • maxResults: Maximum number of results to return (default: 100)
  • detail: Detail level of results ('simple' or 'full', default: 'simple')

ebird_get_nearby_observations_for_species

Get recent observations of a specific bird species near a location.

Parameters:

  • lat (required): Latitude coordinate
  • lng (required): Longitude coordinate
  • speciesCode (required): eBird species code (e.g., amecro for American Crow)
  • dist: Distance in kilometers from lat/lng point (default: 25)
  • back: Number of days back to look for observations (default: 14)
  • maxResults: Maximum number of results to return (default: 100)
  • includeProvisional: Include provisional observations (default: true)

ebird_get_hotspots

Get birding hotspots in a region.

Parameters:

  • regionCode (required): Region code (e.g., US, US-NY)
  • back: Number of days back to look for hotspot activity (default: 14)
  • includeProvisional: Include provisional observations (default: true)

ebird_get_nearby_hotspots

Get birding hotspots near a location.

Parameters:

  • lat (required): Latitude coordinate
  • lng (required): Longitude coordinate
  • dist: Distance in kilometers from lat/lng point (default: 25)
  • back: Number of days back to look for hotspot activity (default: 14)
  • includeProvisional: Include provisional observations (default: true)

ebird_get_taxonomy

Get eBird taxonomy information.

Parameters:

  • locale: Language for common names (default: 'en')
  • cat: Taxonomic category to filter by (default: 'species')
  • fmt: Response format (default: 'json')

ebird_get_taxonomy_forms

Get eBird taxonomy forms for a specific species.

Parameters:

  • speciesCode (required): eBird species code

Testing

To test the eBird MCP server, set your eBird API key as an environment variable and run the test script:

export EBIRD_API_KEY=your_api_key node test-ebird.js

Debug Mode

To enable debug mode and see detailed logging:

node index.js --api-key YOUR_EBIRD_API_KEY --debug

License

MIT

Acknowledgements

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that allows AI assistants to access bird observation data, hotspots, and taxonomy information from eBird.

  1. Quick Setup for Claude Desktop
    1. Features
      1. Prerequisites
        1. Installation
          1. For Claude Desktop
          2. For Other MCP Clients
          3. Manual Installation
        2. Available Tools
          1. ebird_get_recent_observations
          2. ebird_get_recent_observations_for_species
          3. ebird_get_notable_observations
          4. ebird_get_nearby_observations
          5. ebird_get_nearby_notable_observations
          6. ebird_get_nearby_observations_for_species
          7. ebird_get_hotspots
          8. ebird_get_nearby_hotspots
          9. ebird_get_taxonomy
          10. ebird_get_taxonomy_forms
        3. Testing
          1. Debug Mode
            1. License
              1. Acknowledgements

                Related MCP Servers

                • -
                  security
                  F
                  license
                  -
                  quality
                  A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
                  Last updated -
                  2
                  Python
                  • Apple
                  • Linux
                • -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.
                  Last updated -
                  1
                  TypeScript
                • -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that connects AI assistants like Claude to Moneybird accounting software, enabling management of contacts, financial data, products, and business operations through natural language.
                  Last updated -
                  1
                  JavaScript
                  MIT License
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  A customizable Model Context Protocol server implementation that enables AI models to interact with external tools including weather queries, Google search, and camera control functionality.
                  Last updated -
                  8
                  Python
                  Apache 2.0
                  • Linux
                  • Apple

                View all related MCP servers

                ID: faxy5buxs0