lookup_xref
Map a VFB ID to its external database accessions, or an external accession back to the VFB term that carries it. USE THIS INSTEAD OF search_terms FOR ANY EXTERNAL ACCESSION — a hemibrain/FAFB/MANC bodyId, a CATMAID skeleton id, a neuprint id. Free-text search on a bare number ranks a plausible near-miss first and gives you no way to tell a real match from a good guess; this tool confirms the accession against each candidate term's own cross-reference list and returns a row only if that term really carries it. Each row gives the VFB id, label, site (db, db_label, site_id), the accession and a resolved deep link into the external site. Pass exactly one of id or accession. THE TWO DIRECTIONS DIFFER WHEN EMPTY: an empty id->accession result is authoritative (the term has no cross-references); an empty accession->id result means the search index did not reach a term carrying that accession, NOT that no such term exists — report it as "could not confirm", never as "does not exist", and do not substitute a search_terms guess.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "lookup_xref"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| db | No | Optional site filter. Matches a site symbol ("hb"), short_form ("neuprint_JRC_Hemibrain_1point2point1") or label, ignoring case, punctuation and spacing, and also accepts whole words from those names — "flywire", "hemibrain", "neuprint", "catmaid", "male-cns" all work. When set, the response carries db_matched and available_dbs; a filtered empty result means "none from this site", not "none at all". | |
| id | No | A VFB ID to list external accessions for (e.g. VFB_jrchjtdb). Mutually exclusive with accession. | |
| accession | No | An external accession to resolve back to a VFB term (e.g. 1734350908 for a hemibrain bodyId). Mutually exclusive with id. |