AviBase MCP Server

Instructions

Implementation Reference

• mcp-server.js:567-617 (handler)

  The handler function for 'get_bird_report' that takes scientific_name, fetches data from the bird API, and returns a comprehensive formatted Markdown report including taxonomy, conservation status, distribution, and related species.

    async handleGetBirdReport(args) {
      const { scientific_name } = args;
      const endpoint = `/bird/${encodeURIComponent(scientific_name)}`;
      const response = await this.makeAPIRequest(endpoint);
  
      const bird = response.data.bird;
      const related = response.data.relatedInFamily;
  
      return {
        content: [
          {
            type: 'text',
            text: `# Detailed Report: ${bird.Scientific_name}
  
  ## Basic Information
  - **Scientific Name:** ${bird.Scientific_name}
  - **Common Name:** ${bird.English_name_AviList || 'No common name available'}
  - **Alternative Names:** ${bird.English_name_Clements_v2024 || bird.English_name_BirdLife_v9 || 'None listed'}
  - **Taxonomic Authority:** ${bird.Authority || 'Unknown'}
  
  ## Taxonomic Classification
  - **Order:** ${bird.Order}
  - **Family:** ${bird.Family} (${bird.Family_English_name || 'Family name not available'})
  - **Taxonomic Rank:** ${bird.Taxon_rank}
  
  ## Conservation & Status
  - **IUCN Red List Category:** ${bird.IUCN_Red_List_Category || 'Not assessed'}
  - **Conservation Status:** ${response.data.conservationStatus}
  - **Extinction Status:** ${bird.Extinct_or_possibly_extinct || 'Not extinct'}
  
  ## Geographic Distribution
  ${bird.Range ? `**Range:** ${bird.Range}` : '**Range:** No range data available'}
  
  ## Additional Information
  - **Type Locality:** ${bird.Type_locality || 'Not specified'}
  - **Original Description:** ${bird.Title_of_original_description || 'Not available'}
  - **Bibliographic Details:** ${bird.Bibliographic_details || 'Not available'}
  
  ## External Resources
  ${response.data.hasUrls.birdLife ? `- **BirdLife DataZone:** Available` : ''}
  ${response.data.hasUrls.birdsOfTheWorld ? `- **Birds of the World:** Available` : ''}
  ${response.data.hasUrls.originalDescription ? `- **Original Description:** Available` : ''}
  - **Species Code:** ${bird.Species_code_Cornell_Lab || 'Not available'}
  - **AvibaseID:** ${bird.AvibaseID || 'Not available'}
  
  ## Related Species in ${bird.Family}
  ${related.length > 0 ? related.map((rel, i) => `${i + 1}. **${rel.Scientific_name}** - ${rel.English_name_AviList || 'No common name'}`).join('\n') : 'No related species data available'}`,
          },
        ],
      };
    }

• mcp-server.js:220-229 (schema)

  Input schema definition for the 'get_bird_report' tool, requiring a 'scientific_name' string parameter.

  inputSchema: {
    type: 'object',
    properties: {
      scientific_name: {
        type: 'string',
        description: 'Scientific name of the bird species (e.g., "Aquila chrysaetos")',
      },
    },
    required: ['scientific_name'],
  },

• mcp-server.js:217-230 (registration)

  Registration of the 'get_bird_report' tool in the ListTools response, including name, description, and input schema.

  {
    name: 'get_bird_report',
    description: 'Get a detailed report for a specific bird species including related species and comprehensive information.',
    inputSchema: {
      type: 'object',
      properties: {
        scientific_name: {
          type: 'string',
          description: 'Scientific name of the bird species (e.g., "Aquila chrysaetos")',
        },
      },
      required: ['scientific_name'],
    },
  },

• mcp-server.js:312-313 (registration)

  Dispatch case in the CallToolRequest handler that routes 'get_bird_report' calls to the handleGetBirdReport method.

  case 'get_bird_report':
    return await this.handleGetBirdReport(args);