Get StartedAI Agents and MCPCoding Agents

Coding Agents

Setup steps for connecting Claude Code, Codex, Cursor, VS Code, opencode, Windsurf and Gemini CLI to Credible's MCP server to query published data models

A coding agent connected to Credible's MCP server can query your published data models from Claude Code, Codex, Cursor, VS Code or another coding tool, with the same access you have in the Credible app.

To build or change models from a coding agent instead, use the Cred CLI or the VS Code extension. They set up a local server and the modeling skills for you.

Prerequisites

  • You need a Credible account in an organization with at least one published package you can read.

  • The MCP server URL is:

    https://mcp.credibledata.com/global/
  • Every client signs in with OAuth as you, so there is no key to copy. Queries run with your permissions.

  • In the Credible app, Connect AI shows these steps with the URL filled in, for every agent here except Gemini CLI. For Gemini CLI, use the steps below, or Any other MCP client. It can also give you a URL scoped to one organization, workspace or package. A scoped URL narrows where the agent looks; it does not change what you can access. See MCP Server and Tools.

Claude Code

The Credible plugin installs the connection and the analysis skills. Run these slash commands inside a Claude Code session:

/plugin marketplace add credibledata/credible-plugin
/plugin install credible@credible

Then run /mcp and sign in to Credible.

The first command is required: Claude Code only has Anthropic's own marketplace added by default. Credible is also listed in Anthropic's community catalog, but that listing can lag behind releases, so use credibledata/credible-plugin.

For the connection without the skills, or to use a scoped URL, run this in your terminal instead, then run /mcp in a session and sign in:

claude mcp add --transport http credible https://mcp.credibledata.com/global/

Codex

Run these in your terminal before you start Codex. A running session won't see the server until it restarts.

codex mcp add credible --url https://mcp.credibledata.com/global/
codex mcp login credible

Both write to ~/.codex/config.toml, which you can edit directly instead:

[mcp_servers.credible]
url = "https://mcp.credibledata.com/global/"
auth = "oauth"

Older Codex builds read only local (stdio) servers and skip this one without a warning. If the server doesn't appear, upgrade Codex, or add this above the server entry:

[features]
experimental_use_rmcp_client = true

In the Codex IDE extension or app, add the server in its MCP settings as a Streamable HTTP server with the same URL, then authenticate.

Cursor

Connect AI has a link that opens Cursor with the server filled in. To add it by hand, run Open MCP Settings from the command palette, click Add MCP Server, and add:

{
  "mcpServers": {
    "credible": {
      "url": "https://mcp.credibledata.com/global/"
    }
  }
}

Put it in .cursor/mcp.json for one project, or ~/.cursor/mcp.json for every project. Cursor opens the sign-in flow in your browser.

VS Code

For GitHub Copilot in VS Code:

  1. Open the command palette and run MCP: Add Server.
  2. Choose HTTP and enter the MCP server URL.
  3. Name the server credible, then sign in to Credible when prompted.

To write the configuration yourself, use .vscode/mcp.json for one workspace, or run MCP: Open User Configuration for every workspace:

{
  "servers": {
    "credible": {
      "type": "http",
      "url": "https://mcp.credibledata.com/global/"
    }
  }
}

opencode

Add the server to opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "credible": {
      "type": "remote",
      "url": "https://mcp.credibledata.com/global/",
      "enabled": true
    }
  }
}

opencode starts the sign-in flow the first time the server asks for it, and keeps the tokens for later sessions.

Windsurf

Add the server to ~/.codeium/windsurf/mcp_config.json, then sign in when Windsurf prompts:

{
  "mcpServers": {
    "credible": {
      "serverUrl": "https://mcp.credibledata.com/global/"
    }
  }
}

Gemini CLI

Add the server, then start gemini. It opens a browser window to sign in.

gemini mcp add -t http credible https://mcp.credibledata.com/global/
gemini

gemini mcp list shows whether the server is connected.

Other Clients

Credible is a remote MCP server over Streamable HTTP, with OAuth sign-in and dynamic client registration. Any client that takes a server URL and handles OAuth this way can connect with the MCP server URL.

What the Agent Can Do

After you connect, the agent has get_context to find the sources and fields a question needs, execute_query to run Malloy queries, search_malloy_docs for Malloy language help, and get_skill to read Credible's analysis guides. See MCP Server and Tools.

The agent's answers depend on what the model describes: see Descriptions and Value Search for the #(doc) and #(index) tags retrieval reads.

Next Steps

On this page