Watson Discovery MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Watson Discovery MCP Server search for Q3 financial reports in the earnings collection"
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.
MCP Watson Discovery Server
A Model Context Protocol (MCP) server that enables secure interaction with Watson Discovery. This server allows AI assistants to list projects, list collections in projects, execute queries through natural language process.
Features
List available projects
List available collections in project
Execute queries in NLP in a collection
Related MCP server: IBM watsonx.data MCP Server
Configuration
Set the following environment variables:
WATSONX_DISCOVERY_APIKEY=
WATSONX_DISCOVERY_URL=
WATSONX_DISCOVERY_VERSION=2023-03-31Usage
With Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"watsonx-discovery": {
"command": "wsl.exe",
"args": [
"bash",
"-c",
"/home/morpheus/.local/bin/uv --directory /home/morpheus/workspace/mcp-discovery run 'server/__main__.py'"
]
}
}
}As a standalone server
# Install dependencies
uv install
# Run the server
uv run server/__main__.pyDevelopment
# Clone the repository
git clone https://github.com/matlock08/watson_discovery_mcp.git
cd watson_discovery_mcp
# Create virtual environment
uv venv
source venv/bin/activate # or `venv\Scripts\activate` on Windows
# Install development dependencies
uv install
# Run
uv run run server/__main__.py
env WATSONX_DISCOVERY_APIKEY= env WATSONX_DISCOVERY_URL= env WATSONX_DISCOVERY_VERSION=2023-03-31 uvx mcp-watson-discovery License
MIT License - see LICENSE file for details.
Available Tools
3 toolsget_projectsA
Watson Discovery Get Projects
Description
The Watson Discovery Get Projects tool provides access to IBM Watson Discovery's projects, allowing you to retrieve a list of all available projects in your Watson Discovery instance. This tool returns both the human-readable project names and their corresponding unique identifiers (UUIDs) for use in subsequent operations.
Function
This tool connects to your IBM Watson Discovery instance using your provided authentication credentials, queries the available projects, and returns structured information about each project.
Use Cases
Inventory management of Watson Discovery projects
Project selection for further operations, such as querying or collection management
Pre-processing step before performing operations on specific projects
Integration with automated workflows that require project UUIDs
Authentication
This tool requires valid IBM Cloud IAM API credentials to access your Watson Discovery instance. Ensure your service account has appropriate permissions to list projects.
Output Format
Results are returned as a structured array of project objects, each containing:
name: The project name (string)project_id: The project's UUID (string in UUID format)type: The type of project Possible values: [intelligent_document_processing,document_retrieval,conversational_search,content_mining,content_intelligence,other] (string)collection_count: The number of collections configured in this project (integer)
Inputs: no named parameters.
list_project_collectionsA
Watson Discovery List Project Collections
Description
The Watson Discovery List Project Collections return a lists of existing collections for the specified project and returns structured information about each collection
Function
This tool connects to your IBM Watson Discovery instance using your provided authentication credentials, listing the available collections of a project, and returns structured information about each collection.
Use Cases
Inventory management of Watson Discovery collections
Collection selection for further operations, such as querying
Pre-processing step before performing operations on specific projects and collections
Integration with automated workflows that require collection UUIDs
Authentication
This tool requires valid IBM Cloud IAM API credentials to access your Watson Discovery instance. Ensure your service account has appropriate permissions to list collections.
Output Format
Results are returned as a structured array of collections objects, each containing:
name: The collection name (string)collection_id: The collection's UUID (string in UUID format)
Inputs: project_id (required).
query_projectA
Watson Discovery Query Project
Description
Search your data by submitting queries that are written in natural language for the specified project and collections. The query returns a list of documents that match the query criteria.
Function
This tool connects to your IBM Watson Discovery instance using your provided authentication credentials, listing the available documents of a project and collections, and returns structured information about each document.
Use Cases
Search and retrieve documents from a specific project and collection
Integration with automated workflows that require document retrieval
Authentication
This tool requires valid IBM Cloud IAM API credentials to access your Watson Discovery instance. Ensure your service account has appropriate permissions to query projects.
Output Format
Results are returned as a structured array of result objects, each containing:
document_id: The unique identifier of the document (string)result_metadata: Metadata of a query result (object)metadata: Metadata of the document (object)document_passages: Passages from the document that best matches the query (object)
Inputs: project_id (required), collection_id (required), natural_language_query (required), count, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct purpose: get_projects lists projects, list_project_collections lists collections for a project, and query_project retrieves documents. There is no overlap or ambiguity.
All tools use snake_case with a consistent verb_noun pattern (get_projects, list_project_collections, query_project). No mixing of styles.
With only 3 tools, the server is quite minimal for a service like Watson Discovery, which typically involves many more operations. However, it provides a basic read-only workflow, so it is borderline acceptable.
The server only supports read operations (list projects, list collections, query). Missing create, update, delete for projects and collections, as well as document management features, leaving significant gaps for agents.
Maintenance
Related MCP Connectors
Discover agents, services and capabilities; preview and route work. Discovery is free.
Read-only AgentiScript concept search, catalog, authenticity, license, and approved asset discovery.
Connect assistants to your workspace knowledge, skills, and work tools.
Interact with your Google Cloud Firestore resources using natural language commands.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with OSDU platform services including search, data management, and schema operations.9Apache 2.0

IBM watsonx.data MCP Serverofficial
AlicenseBqualityBmaintenanceEnables AI assistants to interact seamlessly with IBM watsonx.data lakehouses using natural language for operations like querying, catalog browsing, engine management, and data ingestion.39260 PyPI9Apache 2.0- AlicenseNot gradedqualityBmaintenanceConnects AI coding assistants to Google Cloud Discovery Engine APIs for semantic search, conversational RAG, and administration of datastores, documents, and configurations.Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with CA Clarity PPM for discovery, CRUD operations, and analytics.1MIT