Skip to main content
Glama
Watson Discovery MCP Server

Watson Discovery MCP Server

by matlock08

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-31

Usage

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__.py

Development

# 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 tools
get_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

    A3.9/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools use snake_case with a consistent verb_noun pattern (get_projects, list_project_collections, query_project). No mixing of styles.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers