MCP Toolbox SDK (JS)
Javascript SDK for interacting with the MCP Toolbox for Databases.
What is MCP Toolbox SDK (JS)?
MCP Toolbox SDK (JS) is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to javascript sdk for interacting with the mcp toolbox for databases.
Javascript SDK for interacting with the MCP Toolbox for Databases.
This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Javascript SDK for interacting with the MCP Toolbox for Data
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @toolbox-sdk/coreManual Installation
npx -y @toolbox-sdk/coreConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Toolbox SDK (JS)
The MCP Toolbox SDK for JavaScript is Google's official client library that allows Node.js and browser-based applications to connect to a running MCP Toolbox for Databases server and use its pre-defined database tools as standard JavaScript functions. The core package (@toolbox-sdk/core) is framework-agnostic and works with any agentic application, while @toolbox-sdk/adk provides an integration tailored for Google's Agent Development Kit. It abstracts away the MCP protocol details so developers can load a named toolset from the Toolbox server and call database operations directly in their agent code, with built-in support for client-to-server authentication and per-tool parameter binding.
Prerequisites
- Node.js v18 or later (required for native fetch and other runtime APIs)
- A running MCP Toolbox for Databases server instance (see https://mcp-toolbox.dev for server setup)
- npm or yarn for package installation
- TypeScript support is built in — no separate @types package needed
Install the core SDK
Install the framework-agnostic core package from npm. This package provides the ToolboxClient class used to connect to a Toolbox server.
npm install @toolbox-sdk/coreOr install the ADK SDK for Google ADK applications
If you are building with Google's Agent Development Kit, install the ADK-specific package instead.
npm install @toolbox-sdk/adkInstantiate the ToolboxClient
Import ToolboxClient and point it at the URL of your running MCP Toolbox server. The URL is typically the address where the Toolbox server process is listening.
import { ToolboxClient } from '@toolbox-sdk/core';
const client = new ToolboxClient('http://localhost:5000');Load a toolset and use the tools
Call loadToolset() to retrieve the tools defined on the server. Each tool is returned as a callable JavaScript function that accepts the tool's input parameters.
async function run() {
const tools = await client.loadToolset();
// tools is an array of callable tool functions
// Call a specific tool by name:
const result = await tools.find(t => t.name === 'search-products').execute({
query: 'wireless headphones',
limit: 10
});
console.log(result);
}
run();Add authentication if required
If your Toolbox server requires authentication, pass an auth callback or token to the client. The SDK supports both client-level and per-tool authentication.
const client = new ToolboxClient('http://localhost:5000', {
auth: async () => ({ Authorization: `Bearer ${await getToken()}` })
});Bind parameters for reusable tool calls
Use parameter binding to pre-fill common values (such as a user ID) so they don't need to be repeated on every tool invocation.
const tool = await client.loadTool('get-user-orders');
const boundTool = tool.bindParams({ userId: 'user-123' });
const orders = await boundTool.execute({ status: 'shipped' });MCP Toolbox SDK (JS) Examples
Client configuration
Using the MCP Toolbox SDK in an MCP host configuration — register the Toolbox server endpoint so the SDK client can discover tools.
{
"mcpServers": {
"toolbox": {
"command": "npx",
"args": ["-y", "@toolbox-sdk/core"],
"env": {
"TOOLBOX_URL": "http://localhost:5000"
}
}
}
}Prompts to try
Once integrated into an AI agent, the Toolbox SDK enables database-backed queries through natural language.
- "Search the product catalog for items under $50 in the electronics category"
- "Retrieve all orders for customer ID 4821 placed in the last 30 days"
- "Run the 'inventory-check' tool and tell me which items are below reorder threshold"
- "List all available tools from the Toolbox server and describe what each one does"Troubleshooting MCP Toolbox SDK (JS)
ToolboxClient throws 'Failed to fetch' or ECONNREFUSED
Ensure the MCP Toolbox for Databases server is running and reachable at the URL you passed to the ToolboxClient constructor. Check the server docs at https://mcp-toolbox.dev to start the server process.
loadToolset() returns an empty array
The Toolbox server must have tools configured in its toolbox.yaml (or equivalent config file). Verify the server configuration includes at least one tool definition and that the server restarted after changes.
TypeScript type errors when calling tool.execute()
The SDK ships with TypeScript types. Ensure you are using Node.js v18+ and that your tsconfig.json targets ES2020 or later. Run npm install @toolbox-sdk/core again to ensure the types package is installed.
Frequently Asked Questions about MCP Toolbox SDK (JS)
What is MCP Toolbox SDK (JS)?
MCP Toolbox SDK (JS) is a Model Context Protocol (MCP) server that javascript sdk for interacting with the mcp toolbox for databases. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Toolbox SDK (JS)?
Install via npm with the command: npx -y @toolbox-sdk/core. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with MCP Toolbox SDK (JS)?
MCP Toolbox SDK (JS) works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Toolbox SDK (JS) free to use?
Yes, MCP Toolbox SDK (JS) is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
MCP Toolbox SDK (JS) Alternatives — Similar Databases Servers
Looking for alternatives to MCP Toolbox SDK (JS)? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.
Excelize
★ 20.6kGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets
MCP Toolbox for Databases
★ 15.3kOpen source MCP server specializing in easy, fast, and secure tools for Databases.
DBHub
★ 2.8kA universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.
Tabularis
★ 2.1kA lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.
Postgres AI Guide
★ 1.7kMCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Anyquery
★ 1.7k🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.
Browse More Databases MCP Servers
Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Toolbox SDK (JS) in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Toolbox SDK (JS)?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.