Skip to content
Eden Engine

OBIS Taxon by Scientific Name: Matching Taxon Records and Classification

obis/taxon-by-name

Returns the OBIS (Ocean Biodiversity Information System) taxon records whose scientific name equals the given name, such as Mola mola or the genus Gadus: the taxon id (the WoRMS AphiaID), rank, status and accepted name, the classification from kingdom to species, habitat flags (marine, brackish, freshwater, terrestrial), the NCBI id and English common names when held. A name can match several records, for example an accepted genus and an unaccepted homonym. An exact name only, not a fuzzy search; a name OBIS does not hold returns an empty result list. Taxon registry only, not occurrence records. Ocean Biodiversity Information System data as served by Eden Engine; not an official OBIS product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

Ocean Biodiversity Information System (OBIS) taxon registry

Taxon data from the Ocean Biodiversity Information System (OBIS), obis.org; taxon ids follow the World Register of Marine Species (WoRMS), which is open access under CC BY. Cite OBIS and WoRMS. Occurrence and dataset records are not included. Served by Eden Engine; not an official OBIS product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "obis/taxon-by-name" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "obis/taxon-by-name" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "obis/taxon-by-name", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "obis/taxon-by-name", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 20, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z .-]{1,79}$",
      "description": "Scientific name, for example Mola mola or Gadus. Letters, spaces, dots and hyphens only; matching is case-insensitive and exact."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "total",
    "results"
  ],
  "properties": {
    "total": {
      "type": "integer",
      "description": "Number of records found."
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "class": {
            "type": "string",
            "description": "Class."
          },
          "genus": {
            "type": "string",
            "description": "Genus."
          },
          "order": {
            "type": "string",
            "description": "Order."
          },
          "family": {
            "type": "string",
            "description": "Family."
          },
          "phylum": {
            "type": "string",
            "description": "Phylum."
          },
          "kingdom": {
            "type": "string",
            "description": "Kingdom."
          },
          "ncbi_id": {
            "type": "integer",
            "description": "NCBI taxonomy id, when OBIS holds one."
          },
          "species": {
            "type": "string",
            "description": "Species name."
          },
          "taxonID": {
            "type": "integer",
            "description": "Taxon id; the same number is the WoRMS AphiaID."
          },
          "category": {
            "type": "string",
            "description": "Conservation category code, such as VU, when OBIS holds one."
          },
          "is_marine": {
            "type": "boolean",
            "description": "Whether the taxon lives in the sea."
          },
          "taxonRank": {
            "type": "string",
            "description": "Rank, for example Species or Genus."
          },
          "is_brackish": {
            "type": "boolean",
            "description": "Whether it lives in brackish water."
          },
          "is_freshwater": {
            "type": "boolean",
            "description": "Whether it lives in fresh water."
          },
          "is_terrestrial": {
            "type": "boolean",
            "description": "Whether it lives on land."
          },
          "scientificName": {
            "type": "string",
            "description": "Scientific name."
          },
          "taxonomicStatus": {
            "type": "string",
            "description": "accepted or unaccepted."
          },
          "vernacularNames": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Common names in English."
          },
          "acceptedNameUsage": {
            "type": "string",
            "description": "The accepted name this name resolves to."
          },
          "acceptedNameUsageID": {
            "type": "integer",
            "description": "Id of the accepted name."
          },
          "scientificNameAuthorship": {
            "type": "string",
            "description": "Author and year of the name."
          }
        },
        "additionalProperties": true
      },
      "description": "One record per match. Empty when OBIS holds none. A name can match accepted and unaccepted records."
    }
  },
  "description": "The matching taxon records.",
  "additionalProperties": true
}