worldoftaxonomy

WorldOfTaxonomy Skill

What this does

Turns any free-text question about industry, occupation, medical, trade, or regulatory classification into a grounded answer backed by 1,000+ official taxonomies linked as a single knowledge graph.

When to invoke

Use this skill when the user wants to:

• Assign a standard code to a business description, product, occupation, diagnosis, or document
• Translate a code between systems (NAICS 2022 <-> ISIC Rev 4, SOC 2018 <-> ISCO-08, ICD-10-CM <-> ICD-10-GM, HS 2022 <-> CPC v2.1, etc.)
• Find every cross-system equivalent of a given code
• Browse hierarchy (children, ancestors, siblings, subtree) of a system
• Compare two systems' coverage or structure
• Audit data provenance and crosswalk density across systems

Do NOT invoke for general explanations of what NAICS/ISIC/ICD are - answer from general knowledge unless the user wants live data.

How to use

Primary: REST API

Base URL: https://worldoftaxonomy.com/api/v1

Auth: Authorization: Bearer wot_<32hex> (get a key at https://worldoftaxonomy.com/dashboard). Anonymous access works at 30 req/min; authenticated keys get 1000-50000 req/min depending on tier.

Core endpoints:

GET  /systems                                       # list systems
GET  /systems/{id}                                  # detail + roots
GET  /systems/{id}/nodes/{code}                     # node detail
GET  /systems/{id}/nodes/{code}/children
GET  /systems/{id}/nodes/{code}/ancestors
GET  /systems/{id}/nodes/{code}/siblings
GET  /systems/{id}/nodes/{code}/equivalences        # crosswalk edges
GET  /search?q=<term>&system=<optional>
POST /classify                                      # body: {"description": "..."}
GET  /equivalences/stats                            # coverage matrix

OpenAPI spec: https://worldoftaxonomy.com/api/v1/openapi.json

Secondary: MCP server

For MCP-aware clients, install world_of_taxonomy from the GitHub repo and run python -m world_of_taxonomy mcp as a stdio server. Tools include classify_business, translate_code, translate_across_all_systems, get_equivalences, get_crosswalk_coverage, get_system_diff, explore_industry_tree, and list_crosswalks_by_kind.