home / mcp / avibase mcp server

AviBase MCP Server

The MCP tool for the AviBase MCP

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kshayk-avibase-mcp": {
      "url": "http://shayk.dev/avibase-mcp"
    }
  }
}

You can run the AviBase MCP Server to give AI assistants fast, structured access to extensive bird data, including taxonomy, conservation status, geography, and historical references. This MCP server acts as a bridge between AI tools and AviBase data, enabling powerful, queryable access for researchers, educators, and developers building bird-related applications.

How to use

You use the AviBase MCP Server by connecting your MCP client to the server’s endpoints or by running the local MCP server executable. Once connected, you can perform a variety of data queries against the AviBase dataset, including taxonomy lookups, region-based searches, conservation status filtering, and custom, JSONata-powered analyses. The server exposes a set of tools that let you query statistics, search by name, filter by taxonomic level, retrieve conservation data, and generate detailed reports for individual species.

How to install

Prerequisites: ensure you have Node.js version 14 or higher and npm or yarn installed on your system.

Install via npm:

npm install @kshayk/avibase-mcp

Install from source:

git clone <repository-url>
cd mcp-package
npm install

Additional notes

The server exposes an HTTP endpoint for MCP clients to connect to, and it can also be run locally via a standard stdio transport. The documented HTTP endpoint is shown below, and you can also start a local instance using Node directly.

API endpoint and local start

API Endpoint for MCP clients to connect to: http://shayk.dev/avibase-mcp

Available tools

get_bird_stats

Get comprehensive statistics about the bird dataset, including total records, species count, families, orders, and conservation categories.

search_birds

Search for birds by scientific or common name with optional fuzzy matching and result limits.

get_birds_by_taxonomy

Filter birds by a taxonomic level such as Order, Family, or Taxon_rank and return matching results.

get_conservation_status

Retrieve birds by IUCN Red List conservation status with an optional result limit.

get_birds_by_region

Find birds by geographic region or range with an optional limit.

get_extinct_species

Return all extinct or possibly extinct bird species.

get_birds_by_authority

Find birds described by a specific taxonomic authority.

get_random_birds

Provide a random sample of birds for exploration.

get_bird_report

Get a detailed report for a specific bird species by its scientific name.

custom_bird_query

Perform complex queries with multiple filters to retrieve tailored results.

execute_jsonata_query

Run raw JSONata queries for advanced data analysis and extraction.