MCP Server

WisdomAI provides a hosted Model Context Protocol (MCP) server that lets you connect AI tools — such as Claude, Cursor, VS Code, and ChatGPT — directly to your WisdomAI domains. Once connected, you can ask natural language questions about your data and receive structured responses including text, tables, and interactive charts.

Endpoint

The WisdomAI MCP Server is available at a single endpoint:

https://{ACCOUNT}.wisdom.ai/mcp

Replace {ACCOUNT} with your WisdomAI account subdomain.

Connect Your Client

Add the WisdomAI MCP Server to your preferred AI client using the configuration below.

Claude Code

Run this command in your terminal:

claude mcp add --transport http wisdomai https://{ACCOUNT}.wisdom.ai/mcp

Then authenticate by running /mcp in Claude Code and following the OAuth flow.

Cursor

Add the following to your ~/.cursor/mcp.json file:

{
  "mcpServers": {
    "wisdomai": {
      "url": "https://{ACCOUNT}.wisdom.ai/mcp"
    }
  }
}

VS Code

Add the following to your VS Code MCP settings (.vscode/mcp.json):

{
  "servers": {
    "wisdomai": {
      "type": "http",
      "url": "https://{ACCOUNT}.wisdom.ai/mcp"
    }
  }
}

Other Clients

For any MCP-compatible client, use the following configuration:

Transport	URL
Streamable HTTP (recommended)	https://{ACCOUNT}.wisdom.ai/mcp

Most clients accept a JSON configuration in this format:

{
  "mcpServers": {
    "wisdomai": {
      "url": "https://{ACCOUNT}.wisdom.ai/mcp"
    }
  }
}

If your client does not support remote HTTP connections directly, use the mcp-remote proxy:

{
  "mcpServers": {
    "wisdomai": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://{ACCOUNT}.wisdom.ai/mcp"]
    }
  }
}

Replace {ACCOUNT} with your WisdomAI account url above.

Authentication

When you first connect, your client will prompt you to:

1. Log in with your WisdomAI account.
2. Accept the OAuth authorization.
3. Grant access to the necessary permissions.

The server implements OAuth 2.1 with Dynamic Client Registration (DCR) and Proof Key for Code Exchange (PKCE), following the MCP Authorization specification. This means:

• No manual setup required: clients register automatically.
• Secure token binding: tokens are scoped to your MCP session.
• Session continuity: each session maintains its own context and can handle multiple requests with the same token.

OAuth Discovery Endpoints

The server exposes standard OAuth discovery endpoints for clients that need them:

• Protected Resource Metadata: /.well-known/oauth-protected-resource
• Authorization Server Metadata: /.well-known/oauth-authorization-server

The authorization server metadata endpoint returns the locations of additional endpoints, including:

• DCR: /register (obtained from registration_endpoint)
• Authorization Endpoint: /authorize (obtained from authorization_endpoint)
• Token Endpoint: /token (obtained from token_endpoint)

MCP clients should query the /.well-known/oauth-authorization-server endpoint to discover the actual URLs rather than assuming fixed paths.

Available Tools

Once connected, the following tools are available:

Tool	Description
chat	Ask natural-language questions about your data domains. Returns text, tables, and chart visualizations.
list-domains	Discover available domains and their IDs before making queries.
echo	Test connectivity and verify the request/response flow is working.

Example Prompts

Once connected, try these prompts to start using WisdomAI from your AI client:

• What domains are available in WisdomAI?
• Show me total revenue by region as a table
• What are the top 5 products by sales this quarter?
• Visualize monthly active users over the last 12 months
• What can I ask about the Sales domain?

Test with MCP Inspector

You can test the WisdomAI MCP Server using the MCP Inspector:

1. Install and launch the MCP Inspector:

   npx @modelcontextprotocol/inspector
   

2. In the Inspector, enter your MCP server URL:

   https://{ACCOUNT}.wisdom.ai/mcp
   

3. Click Connect. The Inspector will automatically handle the OAuth authorization flow.

4. Once connected, click List Tools to see the available tools.

5. Select a tool (for example, list-domains) and click Call to test it.

The Inspector provides an interactive interface to test tool calls, inspect responses, and debug authentication.

Troubleshooting

Issue	Resolution
OAuth authentication fails	Ensure your client supports OAuth. Try reauthenticating using your client’s MCP management flow.
Tools not appearing	Verify that authentication completed successfully and that you have access to at least one WisdomAI domain.
Connection timeout	Check that the server URL is correct (https://{ACCOUNT}.wisdom.ai/mcp) and that your network allows outbound HTTPS connections.
Empty responses from chat	Make sure you are providing a valid domainId. Use the list-domains tool first to find available domain IDs.

For any queries or support, contact our team at [e-mail].