ToolRegistry
English Version | 中文版
A protocol-agnostic tool management library for function-calling LLMs.
Ecosystem
| Package | Description | PyPI | Docs |
|---|---|---|---|
| toolregistry | Core library — tool registration, schema generation, execution | |
Docs |
| toolregistry-server | Server adapters — expose tools via OpenAPI & MCP |  |
Docs |
| toolregistry-hub | Ready-to-use tools — calculator, web search, file ops, etc. |  |
Docs |
toolregistry (core)
↓
toolregistry-server (tool server)
↓
toolregistry-hub (tool collection + server config)
Features
- Protocol-agnostic — register tools from native Python functions/classes, MCP servers, OpenAPI specs, or LangChain tools through a unified interface
- Multi-provider schemas — generate tool schemas for OpenAI, Anthropic, and Gemini via llm-rosetta
- Concurrent execution — thread and process pool backends with per-tool timeout and concurrency control
- Permission system — tag-based policies (
READ_ONLY,DESTRUCTIVE,NETWORK, etc.) with allow/deny/ask rules - Tool metadata & tags — classify tools with
ToolTag,ToolMetadata, namespace support, and source tracking - Admin panel — built-in Web UI for monitoring tools, permissions, and runtime config (i18n: EN/ZH)
- Think-augmented calling — inject chain-of-thought reasoning into tool calls (arXiv:2601.18282)
- Declarative config — load tool sources from JSONC/YAML config files
- Zero-dependency core — HTTP client, YAML parser, JSON Schema resolver all vendored; only
pydanticandllm-rosettaas runtime deps
Quick Start
from toolregistry import ToolRegistry
registry = ToolRegistry()
@registry.register
def add(a: float, b: float) -> float:
"""Add two numbers together."""
return a + b
# Use with any LLM provider
schemas = registry.get_schemas(api_format="openai-chat") # or "anthropic", "gemini"
result = registry["add"](1, 2) # 3.0
See the Usage Guide for MCP, OpenAPI, LangChain integrations and more.
Installation
Requires Python >= 3.10.
pip install toolregistry # core
pip install toolregistry[mcp] # + MCP support
pip install toolregistry[langchain] # + LangChain support
pip install toolregistry-hub # ready-to-use tools (separate package)
Citation
@software{toolregistry2025,
title={ToolRegistry: A Protocol-Agnostic Tool Management Library for OpenAI-Compatible LLM Applications},
author={Peng Ding},
year={2025},
url={https://github.com/Oaklight/ToolRegistry},
note={A Python library for unified tool registration, execution, and management across multiple protocols in OpenAI-compatible LLM applications}
}
@article{ding2025toolregistry,
title={Toolregistry: A protocol-agnostic tool management library for function-calling llms},
author={Ding, Peng and Stevens, Rick},
journal={arXiv preprint arXiv:2507.10593},
year={2025}
}
License
MIT — see LICENSE for details.
1 maintainer
Release files for toolregistry 0.18.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| toolregistry-0.18.1.tar.gz | 360.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| toolregistry-0.18.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 637.8 kB
Release files / toolregistry-0.18.1.tar.gz
| Download URL | toolregistry-0.18.1.tar.gz |
|---|---|
| Size | 360.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fe639bb043fd94e4d34c02e8cfd06e0751de4bb0a95b0c1307013d625778cf65
|
|
BLAKE2b-256 checksum How to use checksums |
44dd5553167822f3308250b9f2a7827aa22d0c13d66846f74a2ea6691414676f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.
Transparency logRelease files / toolregistry-0.18.1-py3-none-any.whl
| Download URL | toolregistry-0.18.1-py3-none-any.whl |
|---|---|
| Size | 277.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6dc988bb1de14c86a8b782143c195d9c9212cf58143e5e62b9f27427121d21b9
|
|
BLAKE2b-256 checksum How to use checksums |
fe5f75370c48e8fe37df1c57f7a99fb46fc1ada2ce568f6beee85d2017a74453
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.
Transparency log
