Skip to main content
Looking to connect Claude Desktop or other AI assistants? See AI Assistants (MCP) for connecting consumer AI tools to your data.
Build custom AI agents that can intelligently query and understand your data using the Model Context Protocol (MCP). Credible’s MCP server supports remote HTTPS connections, allowing you to integrate with any MCP client or agent framework.

​
Authentication Setup

​
Create a Service Account (CLI)

Coming Soon: Detailed CLI instructions for creating service accounts and issuing API keys will be added here.
To connect your custom agent, you’ll need to:
  1. Create a new Group (via CLI) - e.g., ai_agents_group
  2. Grant permissions to the Group (via CLI) - specify what data and operations the group can access
  3. Create a Service Account (CLI) with your group as the UserGroupId
  4. Issue a token - Call ServiceAccount.issueToken to generate a JWT token
  5. Store the token securely - Save the token in your application’s secure credential storage
Future API calls will act with the permissions of your assigned group. You can add or remove permissions from the group at any time, even after the token is created.

​
Connecting Your Agent

​
Using an MCP Client

Here’s an example using Mastra’s MCP client: 
import { MCPClient } from '@mastra/mcp';

const httpClient = new MCPClient({
  servers: {
    credible: {
      url: new URL('https://<your-org>.data.credibledata.com/mcp'),

      requestInit: {
        headers: {
          'Authorization': 'ApiKey your-api-key',
        },
      },

      timeout: 60000,
    },
  },
});

// Connect to the server
await httpClient.connect();

// Use the client
const tools = await httpClient.getTools();

​
Authentication Header

All requests to the MCP server must include the API key in the Authorization header: 
Authorization: ApiKey your-api-key

​
Available MCP Tools

Once connected, your agent has access to Credible’s MCP tools for querying semantic models. The primary tools for data analysis are:
  • suggestAnalysis - Converts natural language into Malloy queries and retrieves relevant entities from your semantic models
  • executeQuery - Run Malloy queries against your semantic models and connected database
For complete technical details on all available tools and parameters, see the MCP Reference.
Need different authentication setup? We can support custom authentication flows including federated identity, SSO integration, or embedded credentials. Implementation details vary by use case—contact support@credibledata.com to discuss your requirements.
⌘I