Skip to content

docs: cleanup README#581

Open
AnmolShukla2002 wants to merge 9 commits intogoogleapis:mainfrom
AnmolShukla2002:readme-cleanup
Open

docs: cleanup README#581
AnmolShukla2002 wants to merge 9 commits intogoogleapis:mainfrom
AnmolShukla2002:readme-cleanup

Conversation

@AnmolShukla2002
Copy link

This PR streamlines the README files across the repository to provide a cleaner, more focused onboarding experience. Detailed technical documentation, concepts, and advanced configuration guides have been moved to the central MCP Toolbox Documentation Site

Rationale
Single Source of Truth: Consolidating detailed documentation on the main site ensures consistency and prevents information from becoming stale in repository files.
Improved Maintainability: Reduces the overhead of updating multiple Markdown files for common conceptual or architectural changes.
Focused Onboarding: Keeps the repository lightweight for developers who just need a quick installation command, while providing a clear path for those needing in-depth guides.

@AnmolShukla2002 AnmolShukla2002 requested a review from a team as a code owner March 10, 2026 10:29
## Usage

The primary entry point is the `ToolboxToolset`, which loads tools from a remote Toolbox server and adapts them for use with ADK agents.
The toolbox-adk package provides a seamless bridge to natively use MCP Toolbox tools within ADK agents. For detailed guides and advanced configuration, please visit the following sections on our [Documentation Site](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/adk/):
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The toolbox-adk package provides a seamless bridge to natively use MCP Toolbox tools within ADK agents. For detailed guides and advanced configuration, please visit the following sections on our [Documentation Site](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/adk/):
The `toolbox-adk` package provides a seamless bridge to natively use MCP Toolbox tools within ADK agents. For detailed guides and advanced configuration, please visit the following sections on our [Documentation Site](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/adk/):

}
)
```
- [Transport Protocols](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/adk/#transport-protocols)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see the transport section still has the deprecated TOOLBOX protocol. Can we ensure syncing all the READMEs', across languages and orchestrations, latest contents to the docsite?


This SDK allows you to seamlessly integrate the functionalities of
[Toolbox](https://github.com/googleapis/genai-toolbox) into your LangChain LLM
[MCP Toolbox](https://github.com/googleapis/genai-toolbox) into your LangChain LLM
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[MCP Toolbox](https://github.com/googleapis/genai-toolbox) into your LangChain LLM
[MCP Toolbox](https://github.com/googleapis/genai-toolbox) into your LangChain GenAI

This SDK allows you to seamlessly integrate the functionalities of
[Toolbox](https://github.com/googleapis/genai-toolbox) into your LangChain LLM
[MCP Toolbox](https://github.com/googleapis/genai-toolbox) into your LangChain LLM
applications, enabling advanced orchestration and interaction with GenAI models.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
applications, enabling advanced orchestration and interaction with GenAI models.
applications, enabling advanced orchestration and interaction with LLMs.

# Use client
pass
```
The toolbox-llamaindex package provides a dedicated integration to seamlessly load and use MCP Toolbox tools within the LlamaIndex orchestration framework ( source). For detailed guides and advanced configuration, please visit the following sections on our [Documentation Site](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/llamaindex/):
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The toolbox-llamaindex package provides a dedicated integration to seamlessly load and use MCP Toolbox tools within the LlamaIndex orchestration framework ( source). For detailed guides and advanced configuration, please visit the following sections on our [Documentation Site](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/llamaindex/):
The `toolbox-llamaindex` package provides a dedicated integration to seamlessly load and use MCP Toolbox tools within the LlamaIndex orchestration framework ( source). For detailed guides and advanced configuration, please visit the following sections on our [Documentation Site](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/llamaindex/):

# Use client
pass
```
The toolbox-llamaindex package provides a dedicated integration to seamlessly load and use MCP Toolbox tools within the LlamaIndex orchestration framework ( source). For detailed guides and advanced configuration, please visit the following sections on our [Documentation Site](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/llamaindex/):
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use MCP Toolbox tools within the LlamaIndex orchestration framework ( source)

What exactly do we mean by ( source)?

```py
# Load all tools
tools = toolbox.load_toolset()
Contributions are welcome! Please refer to the [DEVELOPER.md](./DEVELOPER.md)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we prefer to use absolute URLs?

```py
# Load all tools
tools = toolbox.load_toolset()
Contributions are welcome! Please refer to the [DEVELOPER.md](./DEVELOPER.md)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Contributions are welcome! Please refer to the [DEVELOPER.md](./DEVELOPER.md)
Contributions are welcome! Please refer to the [`DEVELOPER.md`](./DEVELOPER.md)

- [Which Package Should I Use?](#which-package-should-i-use)
- [Available Packages](#available-packages)
- [Getting Started](#getting-started)
- [Quick Start](#quick-start)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: We generally have Quickstart as a single word.

| `toolbox-langchain` | LangChain / LangGraph Integration | `packages/toolbox-langchain/` | [LangChain Guide](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/langchain/) |
| `toolbox-llamaindex` | LlamaIndex Integration | `packages/toolbox-llamaindex/` | [LlamaIndex Guide](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/llamaindex/) |

## Quick Start
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Quickstart as a single word?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants