Adaptive Retrieval
MCP Guide

Model Context Protocol (MCP)

Overview

To make Adaptive Retrieval accessible within modern AI clients and agentic frameworks, Adaptive Retrieval supports integration via Model Context Protocol (opens in a new tab) (MCP), which standardizes agentic communication.

Prerequisites

Authentication: You must have S&P Global OAuth credentials. To receive access, please email commercial@kensho.com.

MCP Client Entry

Find the Adaptive Retrieval MCP server information below:

{
    "mcpServers": {
        "kensho-server": {
            "type": "streamable-http",
            "url": "https://grounding.kensho.com/integrations/v2/mcp"
        }
    }
}

Manual Usage

Calling the REST endpoint https://grounding.kensho.com/api/v2/search with body:

{
   "query": "What is Apple's P/E Ratio?"
}

Is equivalent to calling the MCP endpoint https://grounding.kensho.com/integrations/v2/mcp with body:

{
   "jsonrpc": "2.0",
   "method": "tools/call",
   "params": {
       "name": "search",
       "arguments": {
           "query": "What is Apple's P/E Ratio?"
       }
   },
   "id": 1
}

Testing via MCP Inspector

For quick access, you can connect to the Adaptive Retrieval MCP server via MCP Inspector (opens in a new tab), the recommended tool from MCP itself.

Requirements

  • OAuth Credentials — You will need your S&P Global CLIENT_ID
  • npx (opens in a new tab) — This allows you to start up your MCP Inspector Server
  • Node.js version 22.7.5 or greater

Setup Instructions

  1. In a shell with npx installed and an internet connection, run the following command. This will open up your default browser with a UI:
npx @modelcontextprotocol/inspector

  1. In the UI:

    • Under Transport Type select Streamable HTTP
    • Under the URL, paste https://grounding.kensho.com/integrations/v2/mcp
    • Set Connect Type to Via Proxy from the dropdown
    • Under Authentication, provide your S&P Global CLIENT_ID

  2. Click on Open Auth Settings in the center of the UI (in green) and work through the Quick OAuth Flow. When you get to Preparing Authorization, make sure to click the button to take you to an external window for the Authorization URL.

  3. Copy and paste the code from the external tab window.

  4. Click through the rest of the flow. To confirm Auth is set up, it should show all green check marks and say Authentication Complete.

  5. Finally, hit the Connect button on the bottom left. You should see that your MCP Inspector is now connected and a list of dropdowns on the top, including Tools.

Usage

  1. Select Tools > List Tools.

  2. Click on search. You will be able to find the information about the tool and what it does under the search dropdown.

  3. To test the tool, input any query you want into the query menu box. Then click Run Tool. You will see that Tool Result shows Success.