Trefle Tools Reference

Complete reference for all Trefle MCP tools.

Available Tools

The Trefle service provides the following MCP tools:

• trefle.search_plants — Search plants by common or scientific name
• trefle.get_plant — Get a single plant by slug
• trefle.search_species — Search species by common or scientific name
• trefle.get_species — Get a single species by slug
• trefle.metadata — Return service metadata (no auth required)

Tool Details

trefle.search_plants

Search plants using Trefle's v1/plants/search endpoint.

Arguments:

• q (required): Search query (e.g. "coconut", "rose")
• page (optional): Page number (default 1)
• per_page (optional): Results per page (default 30, max 100)
• data_format (optional): "cleaned" (default) or "raw"

Returns: Object with data (array of plants), links, and meta (e.g. total count).

trefle.get_plant

Get a single plant by slug.

Arguments:

• slug (required): Plant slug from Trefle (e.g. "cocos-nucifera")
• data_format (optional): "cleaned" (default) or "raw"

Returns: Single plant object with scientific_name, common_name, family, genus, links, etc.

trefle.search_species

Search species using Trefle's v1/species/search endpoint.

Arguments:

• q (required): Search query
• page (optional): Page number (default 1)
• per_page (optional): Results per page (default 30, max 100)
• data_format (optional): "cleaned" (default) or "raw"

Returns: Object with data (array of species), links, and meta.

trefle.get_species

Get a single species by slug.

Arguments:

• slug (required): Species slug
• data_format (optional): "cleaned" (default) or "raw"

Returns: Single species object.

trefle.metadata

Return service metadata. Does not require Trefle auth.

Arguments: None

Returns: service, name, description, base_url, documentation, auth_required, rate_limit.