WoT
Developers
MCP Server

MCP Tools Reference

23 tools for AI assistants to search, translate, and navigate the taxonomy knowledge graph. Works with Claude, Cursor, VS Code, Windsurf, and any MCP client.

Protocol

JSON-RPC over stdio

Transport

stdin / stdout

Tools

23 available

Connect to Claude Desktop

Add to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "world-of-taxonomy": {
      "command": "/usr/bin/python3",
      "args": ["-m", "world_of_taxonomy", "mcp"],
      "env": {
        "PYTHONPATH": "/path/to/WorldOfTaxonomy",
        "DATABASE_URL": "postgresql://user:pass@host/db?sslmode=require"
      }
    }
  }
}

Replace /path/to/WorldOfTaxonomy with your clone path and supply your DATABASE_URL. Restart Claude Desktop after saving.

Run the server directly

# From the repo root (requires DATABASE_URL in environment)
python3 -m world_of_taxonomy mcp

MCP Resources

In addition to tools, the MCP server exposes resources that clients can read:

taxonomy://systemsList of all classification systems in JSON
taxonomy://statsKnowledge graph statistics in JSON
taxonomy://wiki/{slug}Wiki guide pages in Markdown (10 pages)
Browse & Lookup (8)Search & Discovery (5)Translation & Crosswalks (6)Geography & Countries (2)Comparison & Analysis (2)

Browse & Lookup

Navigate classification hierarchies and retrieve specific codes

list_classification_systems

List all available classification systems with node counts and metadata.

get_industry

Get details for a specific industry code including title, level, and hierarchy position.

Parameters

system_id*stringSystem ID (e.g. naics_2022, isic_rev4)
code*stringIndustry code (e.g. 6211, A01)
browse_children

Get direct children of an industry code to navigate the hierarchy downward.

Parameters

system_id*stringClassification system ID
parent_code*stringParent code to list children of
get_ancestors

Get the full path from root to a specific industry code.

Parameters

system_id*stringClassification system ID
code*stringIndustry code to trace ancestry for
get_siblings

Get other industry codes at the same level under the same parent.

Parameters

system_id*stringClassification system ID
code*stringIndustry code to find siblings for
get_sector_overview

Get top-level sectors/sections for a classification system.

Parameters

system_id*stringClassification system ID
get_subtree_summary

Summarize all codes under a given node: total count, leaf count, max depth.

Parameters

system_id*stringClassification system ID
code*stringRoot code of the subtree
get_leaf_count

Compare granularity across systems: total nodes and leaf (most-specific) node counts.

Parameters

system_idstringOptional: filter to one system

Translation & Crosswalks

Convert codes between systems and explore 321K+ equivalence edges

get_equivalences

Get cross-system equivalences for an industry code (e.g. NAICS to ISIC mappings).

Parameters

system_id*stringSource classification system ID
code*stringSource industry code
translate_code

Translate an industry code from one system to another (e.g. NAICS 6211 to ISIC).

Parameters

source_system*stringSource system ID (e.g. naics_2022)
source_code*stringSource industry code
target_system*stringTarget system ID (e.g. isic_rev4)
translate_across_all_systems

Translate an industry code to every other system in one call. Returns all known equivalences.

Parameters

system_id*stringSource system ID
code*stringSource industry code
get_crosswalk_coverage

Show how many equivalence edges exist between each pair of classification systems.

Parameters

system_idstringOptional: filter to a specific system
get_system_diff

Find codes in system A that have no equivalence mapping to system B.

Parameters

system_id_a*stringSystem to check codes from
system_id_b*stringSystem to check coverage against
describe_match_types

Explain what exact, partial, and broad equivalence match types mean.

Geography & Countries

Map countries to their applicable classification systems

get_region_mapping

List classification systems grouped by geographic region.

get_country_taxonomy_profile

Get the classification systems applicable to a country, plus its known sector strengths. Returns official national system, regional standard, and globally recommended ISIC Rev 4.

Parameters

country_code*stringISO 3166-1 alpha-2 country code (e.g. DE, US, IN)

Comparison & Analysis

Compare systems, audit data quality, and analyze structure

compare_sector

Compare top-level sectors of two classification systems side by side.

Parameters

system_id_a*stringFirst system ID
system_id_b*stringSecond system ID
get_audit_report

Generate an aggregate audit report for data trustworthiness review. Returns provenance tier breakdown, missing file hashes, structural derivation accounting, and skeleton system detection.

Example Conversation

What it looks like in Claude Desktop

user

What NAICS code should I use for a telemedicine platform?

tool

classify_business("telemedicine platform") -> NAICS 621999, ISIC 8620, SOC 29-1171

assistant

NAICS 621999 (All Other Miscellaneous Ambulatory Health Care Services) is the best fit. The ISIC equivalent is 8620 (Medical and dental practice activities). Let me show you the full hierarchy...

tool

get_ancestors("naics_2022", "621999") -> 62 > 621 > 6219 > 621999

assistant

The full NAICS path: 62 (Health Care) > 621 (Ambulatory Health Care) > 6219 (Other Ambulatory) > 621999 (All Other Miscellaneous).

Want to use the REST API instead?

Same data, same coverage - HTTP JSON endpoints with no client library needed.

API Reference