How to Use the watsonx Discovery MCP in Claude Code

Q: How do I query data using watsonx Discovery and Claude Code?

You pipe a command into your shell script calling querydiscoverycontent. You provide the collection ID and query text as arguments. The result is raw, machine-readable output perfect for passing to another tool.

Q: Does watsonx Discovery support advanced querying in Claude Code?

Yes, querydiscoverycontent supports both natural language and DQL queries. You embed this tool call into your shell script to perform complex data lookups during the CI/CD process.

Q: How do I verify the connection between watsonx Discovery and Claude Code?

You run getcomponentsettings in a test job. This validates that your environment can authenticate and communicate with all necessary components of the MCP Server.

Run watsonx Discovery searches in CI/CD pipelines using Claude Code's terminal access.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect watsonx Discovery MCP to Claude Code

Create your Vinkius account to connect watsonx Discovery to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup watsonx Discovery with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Running Searches via the MCP Server

Need to check data as part of a pipeline? You use `query_discovery_content` to perform natural language or DQL queries against collections. The output streams directly to standard output, making it perfect for subsequent shell scripting steps.

Listing Content and Collections

As part of a CI/CD job, you first need an inventory check. You list all available data buckets using `list_discovery_collections` and then verify the documents in each one with `list_collection_documents`. This validates that the deployment environment has access to the required source material.

Checking Project Health for Scripts

Before running any job, you should confirm the setup. You check component status using `get_component_settings` and inspect specific files with `get_document_details`. This guarantees that the entire watsonx Discovery environment is stable before deployment.

Setup guide

Set up watsonx Discovery MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see watsonx-discovery-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest watsonx Discovery transactions." It will automatically discover and invoke the available watsonx Discovery tools.

Terminal

claude mcp add --transport http watsonx-discovery-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the watsonx Discovery MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "watsonx-discovery-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by watsonx Discovery. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect watsonx Discovery now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about watsonx Discovery MCP in Claude Code

You pipe a command into your shell script calling `query_discovery_content`. You provide the collection ID and query text as arguments. The result is raw, machine-readable output perfect for passing to another tool.

The server handles metadata and content indices across various collections within the project. You interact with these resources by listing them or querying their contents directly from the terminal.

Yes, `query_discovery_content` supports both natural language and DQL queries. You embed this tool call into your shell script to perform complex data lookups during the CI/CD process.

You run `get_component_settings` in a test job. This validates that your environment can authenticate and communicate with all necessary components of the MCP Server.

The server manages access to document metadata and collection identifiers. By scripting the calls, you strictly define which resources are queried during your automated pipeline runs.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript