Skip to main content
Glama
matlock08

Watson Discovery MCP Server

by matlock08
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
WATSONX_DISCOVERY_URLYesThe URL of your Watson Discovery instance.
WATSONX_DISCOVERY_APIKEYYesYour Watson Discovery API key.
WATSONX_DISCOVERY_VERSIONNoThe version of Watson Discovery API to use.2023-03-31

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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)

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)

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)

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

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 issues

Resources