search_by_kingdom

Search the ITIS database for organisms within a specific taxonomic kingdom like Animalia or Plantae. Retrieve paginated results to find species by kingdom classification.

Instructions

Search for organisms within a specific kingdom in ITIS database.

Input Schema

TableJSON Schema

Name	Required	Description
`kingdom`	Yes	Kingdom name (e.g., "Animalia", "Plantae", "Fungi", "Bacteria")
`rows`	No	Number of results to return (default: 10)
`start`	No	Starting index for pagination (default: 0)

Implementation Reference

src/tools.ts:324-340 (handler)

MCP tool handler for search_by_kingdom: extracts kingdom, rows, start from arguments, calls itisClient.searchByKingdom, formats and returns the search results as JSON.

case 'search_by_kingdom': {
  const { kingdom, rows, start } = args as any;
  const result = await itisClient.searchByKingdom(kingdom, { rows, start });
  return {
    content: [
      {
        type: 'text',
        text: JSON.stringify({
          kingdom,
          totalResults: result.response.numFound,
          start: result.response.start,
          results: result.response.docs,
        }, null, 2),
      },
    ],
  };
}

src/tools.ts:83-104 (registration)

Registration of the search_by_kingdom tool in the tools array, including name, description, and input schema. Used by the ListTools handler.

{
  name: 'search_by_kingdom',
  description: 'Search for organisms within a specific kingdom in ITIS database.',
  inputSchema: {
    type: 'object',
    properties: {
      kingdom: {
        type: 'string',
        description: 'Kingdom name (e.g., "Animalia", "Plantae", "Fungi", "Bacteria")',
      },
      rows: {
        type: 'number',
        description: 'Number of results to return (default: 10)',
      },
      start: {
        type: 'number',
        description: 'Starting index for pagination (default: 0)',
      },
    },
    required: ['kingdom'],
  },
},

src/tools.ts:86-103 (schema)

Input schema definition for the search_by_kingdom tool, specifying parameters kingdom (required), rows, and start.

inputSchema: {
  type: 'object',
  properties: {
    kingdom: {
      type: 'string',
      description: 'Kingdom name (e.g., "Animalia", "Plantae", "Fungi", "Bacteria")',
    },
    rows: {
      type: 'number',
      description: 'Number of results to return (default: 10)',
    },
    start: {
      type: 'number',
      description: 'Starting index for pagination (default: 0)',
    },
  },
  required: ['kingdom'],
},

src/itis-client.ts:167-175 (helper)

ITISClient helper method that performs the kingdom-specific search by adding a kingdom filter to the general ITIS search.

async searchByKingdom(kingdom: string, options: Partial<ITISSearchOptions> = {}): Promise<ITISResponse> {
  return this.search({
    ...options,
    filters: {
      ...options.filters,
      kingdom: `"${kingdom}"`
    }
  });
}

ITIS MCP Server