Skip to main content
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:
Replace {ACCOUNT} with your WisdomAI account subdomain.
The MCP endpoint must match the domain you use to log in.
  • If you log in via {account}.wisdom.ai, use https://{ACCOUNT}.wisdom.ai/mcp
  • If you log in via {account}.askwisdom.ai, use https://{ACCOUNT}.askwisdom.ai/mcp

​
Connect your client

Add the WisdomAI MCP Server to your preferred AI client using the configuration below.
Run this command in your terminal:
Then authenticate by running /mcp in Claude Code and following the OAuth flow.
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.
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:

​
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:
  2. In the Inspector, enter your MCP server URL:
  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

For any queries or support, contact our team at support@askwisdom.ai.