Tools — API Reference

Concept Tools

`groundworkers.tools.concept_tools`

`register_concept_tools(server, graph_adapter)`

Register deterministic concept lookup tools against the MCP server.

These tools take a known identifier (concept_id, vocabulary+code) and return a fact — they are deterministic lookups, not text matching.

For free-text grounding see resolver_tools.py. For agent-composable search primitives see search_tools.py.

Resolver Tools

`groundworkers.tools.resolver_tools`

`register_resolver_tools(server, graph_adapter)`

Register free-text concept resolution tools against the MCP server.

These tools map unstructured text (clinical terms, natural language, partial descriptions) to OMOP standard concepts. They are probabilistic — results are ranked candidates, not guaranteed matches.

For deterministic lookups from known identifiers (concept_id, vocab+code, hierarchy traversal) see concept_tools.py. For agent-composable primitive search operations see search_tools.py.

Search Tools

`groundworkers.tools.search_tools`

`register_search_tools(server, vocab_adapter)`

Register agent-composable primitive search tools against the MCP server.

Mapping Tools

`groundworkers.tools.mapping_tools`

Embedding Tools

`groundworkers.tools.embedding_tools`

System Tools

`groundworkers.tools.system_tools`

System-level MCP tools: system_status and system_vocabulary_catalogue.

These tools are always registered regardless of adapter availability, so callers always get a structured response (never "unknown tool").

system_status — reports availability of every configured adapter. system_vocabulary_catalogue — returns the full OMOP vocabulary/domain/class catalogue from OmopGraphAdapter. Requires omop_graph to be configured.