How do I use toad-mcp-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@toad-mcp-server search for documents about authentication" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

toad-mcp-server

by vola-trebla

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

toad-mcp-server

TypeScript Node.js MCP Zod ESLint Prettier License

🔌 MCP server exposing portfolio AI tools via Model Context Protocol. Connect to Claude Desktop and call Semantic Search, Eval Framework, and Prompt Management tools directly from chat.

🏗️ Architecture

┌─────────────────────┐    stdio / HTTP     ┌──────────────────────────┐
│   Claude Desktop    │◄────────────────-──►│    toad-mcp-server       │
│   (MCP Client)      │                     │                          │
└─────────────────────┘                     │  ┌────────────────────┐  │
                                            │  │ toad_search_docs   │──┼──► Semantic Search API
                                            │  ├────────────────────┤  │
                                            │  │ toad_run_eval      │──┼──► Eval Framework API
                                            │  ├────────────────────┤  │
                                            │  │ toad_system_status │──┼──► Health checks
                                            │  ├───────────────-────┤  │
                                            │  │ toad_list_prompts  │  │
                                            │  ├────────────────────┤  │
                                            │  │ toad_get_prompt    │  │
                                            │  └────────────────────┘  │
                                            └──────────────────────────┘

Related MCP server: context-repo-mcp

🛠️ Tools

Tool	Description	Read-only
`toad_search_documents`	Semantic search over documents via natural language query	Yes
`toad_run_eval`	Run eval suite against a prompt variant, returns scores	No
`toad_system_status`	Health check all portfolio services (latency, status)	Yes
`toad_list_prompts`	List prompts with pagination and tag filtering	Yes
`toad_get_prompt`	Get prompt by name with version, template, score history	Yes

All tools support response_format: "markdown" | "json" where applicable.

📦 Resources

URI	Description
`toad://system/status`	Health status of all services (JSON)
`toad://prompts/{name}`	Get prompt by name with full metadata (JSON)

🚀 Quick Start

# Install
npm install

# Build
npm run build

# Run (stdio — for Claude Desktop)
npm start

# Run (HTTP — for remote/multi-client access)
TRANSPORT=http npm start

# Dev mode
npm run dev

🖥️ Claude Desktop Setup

Build the server:
```
npm run build
```

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

{
  "mcpServers": {
    "toad-mcp-server": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/absolute/path/to/toad-mcp-server",
      "env": {
        "SEMANTIC_SEARCH_URL": "http://localhost:3001",
        "EVAL_FRAMEWORK_URL": "http://localhost:3002"
      }
    }
  }
}

Restart Claude Desktop — tools appear automatically.

🔍 Testing with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

Opens a web UI to test each tool interactively.

⚙️ Environment Variables

Variable	Default	Description
`SEMANTIC_SEARCH_URL`	`http://localhost:3001`	Semantic Search Engine endpoint
`EVAL_FRAMEWORK_URL`	`http://localhost:3002`	Eval Framework endpoint
`TRANSPORT`	`stdio`	Transport mode: `stdio` or `http`
`PORT`	`3100`	HTTP transport port
`HOST`	`127.0.0.1`	HTTP transport bind address

📜 Scripts

Script	Description
`npm run build`	Compile TypeScript to `dist/`
`npm run dev`	Run with tsx (hot reload)
`npm start`	Run compiled server
`npm run lint`	ESLint check
`npm run format`	Prettier format

🧱 Tech Stack

TypeScript (NodeNext, strict)
@modelcontextprotocol/sdk — MCP server SDK
Zod v4 — input validation
ESLint + Prettier + Husky — code quality
GitHub Actions — CI (lint → format → build)

📄 License

ISC

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

ClaudeHopper
RAG Systems Vector Databases Developer Tools
Arborist-ai
A
license
-
quality
D
maintenance
AI-powered MCP server that enables Claude and other LLMs to interact directly with construction documents, drawings, and specifications through advanced RAG and hybrid search capabilities.
Last updated 2025-04-22
7
MIT
context-repo-mcp
Search RAG Systems Documentation Access
Gitmaxd
A
license
-
quality
A
maintenance
An MCP server that enables AI assistants to manage Context Repo prompts, documents, and collections with semantic search and progressive disclosure navigation.
Last updated 2026-06-11
105
1
MIT
claude-rag-mcp
RAG Systems Knowledge & Memory
VXConsulting
A
license
-
quality
C
maintenance
MCP server providing RAG context and failure capture for Claude Code, enabling semantic search across project knowledge and storing/analyzing failures.
Last updated 2026-02-02
1
MIT
Fast Context MCP
Code Analysis Search Developer Tools
meimingqi222
A
license
-
quality
D
maintenance
Enables AI-driven semantic code search via natural language queries, integrating with MCP clients like Claude Desktop to retrieve relevant code context from any codebase.
Last updated 2026-02-13
MIT

View all related MCP servers

Related MCP Connectors

nyc-property-intel
MCP server giving Claude AI access to 22+ NYC public-record databases for real estate due diligence
mcp
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
pAIchart MCP Hub
MCP Hub: AI service discovery, per-user OAuth, and multi-service workflow orchestration

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vola-trebla/toad-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

toad-mcp-server

🏗️ Architecture

🛠️ Tools

📦 Resources

🚀 Quick Start

🖥️ Claude Desktop Setup

🔍 Testing with MCP Inspector

⚙️ Environment Variables

📜 Scripts

🧱 Tech Stack

📄 License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

ClaudeHopper

context-repo-mcp

claude-rag-mcp

Fast Context MCP

Related MCP Connectors

Latest Blog Posts

MCP directory API