{
  "markdown": "# Credible\n\nThe Credible plugin connects Claude to your [Credible](https://credibledata.com) workspaces so you can ask questions about your data in natural language, get grounded answers from your team's published Malloy semantic models, and run real queries against your warehouse — without leaving the conversation.\n\nThe plugin bundles:\n\n- A Streamable HTTP **MCP server** at `https://mcp.credibledata.com/global` exposing the core analysis tools (`list_workspaces`, `get_context`, `execute_query`, `search_malloy_docs`).\n- A set of **Skills** that teach Claude how to use those tools well — phrase detection, Malloy query patterns, chart selection, analysis pitfalls, Malloy docs lookup, and the canonical analysis workflow.\n\n## What it does\n\nOnce installed, you can ask questions like *\"how many active subscribers did we have last month?\"* or *\"break down revenue by region for Q1\"*. The plugin gives Claude the tools and skills to:\n\n1. Discover which Credible workspaces you have access to (`list_workspaces`).\n2. Search the relevant semantic model for the entities (dimensions, measures, sources) that answer the question (`get_context`).\n3. Compose a valid Malloy query against that model and run it against your warehouse (`execute_query`).\n4. Return rows, summary stats, and chart-ready output to the chat.\n\nYou stay in control: every query is shown before it runs, results are streamed back into the chat, and the underlying Credible permissions (org / workspace / package) are enforced server-side.\n\n## Requirements\n\n- An active [Credible](https://credibledata.com) account with access to at least one published workspace.\n- A Claude surface that supports plugins:\n  - **Claude Cowork** (Desktop)\n  - **Claude Code** (Desktop UI or CLI)\n  - **Claude Desktop** (chat — via \"Upload plugin\")\n- Outbound HTTPS access to `mcp.credibledata.com`.\n\nThe first time you use the plugin, Claude will prompt you to sign in to Credible via OAuth. To revoke access, uninstall the plugin in your Claude client (Cowork → *Plugins*, Claude Desktop → *Settings → Plugins*, or `claude plugin uninstall credible@<marketplace>`).\n\n## Install\n\n### From the community plugin marketplace (recommended)\n\nIn **Claude Code**:\n\n```bash\n/plugin marketplace add anthropics/claude-plugins-community\n/plugin install credible@claude-community\n```\n\nIn **Cowork**: open *Organization settings → Plugins → Browse marketplace* and pick **Credible**.\n\n### Manually from this repo\n\n```bash\n# Claude Code (local clone install)\ngit clone https://github.com/credibledata/credible-plugin.git ~/credible-plugins/credible\nclaude --plugin-dir ~/credible-plugins/credible\n\n# Claude Code CLI marketplace add (no clone)\n/plugin marketplace add credibledata/credible-plugin\n/plugin install credible@credible\n```\n\n### From a release zip\n\nGrab `credible.zip` from the [latest release](https://github.com/credibledata/credible-plugin/releases/latest) and upload it via:\n\n- **Cowork** → *Organization settings → Plugins → Upload plugin*\n- **Claude Desktop** → *Settings → Plugins → Upload plugin*\n\n### OpenCode\n\nThe same Credible MCP server and analysis skills are available for\n[OpenCode](https://opencode.ai). See [`opencode/README.md`](./opencode/README.md)\nin this repository for installation and OAuth instructions.\n\n## Usage examples\n\n> Try these prompts after installing. They assume you have at least one published workspace; Claude will help you pick one if you have several.\n\n### 1. Sanity check — explore what's available\n\n> *\"What Credible workspaces do I have access to, and what kind of data is in each?\"*\n\nClaude will call `list_workspaces` and summarize the orgs / workspaces it sees, then offer to dive into one. Good first-run prompt to confirm the OAuth flow worked end-to-end.\n\n### 2. A natural-language data question\n\n> *\"What was our total revenue for each region in Q1 of last year?\"*\n\nClaude will use the plugin's tools and skills to identify the right `revenue` measure and `region` dimension in the workspace's semantic model (`get_context`), compose a valid Malloy query with the appropriate time filter, run it (`execute_query`), and return both the table and a renderable chart spec. The `malloy-analysis` and `malloy-charts` skills guide it through each step.\n\n### 3. A more advanced analytical question\n\n> *\"Compute year-over-year growth in monthly active users, broken down by plan tier, for the last four quarters.\"*\n\nYear-over-year comparisons aren't a one-liner in Malloy. Claude will use `get_context` to identify the right active-user measure and the `plan_tier` dimension, look up the time-shifting pattern via `search_malloy_docs` if it's unsure, then compose and run a single query via `execute_query`. The `malloy-analysis-pitfalls` skill flags caveats — for example, the ambiguity in \"monthly\" (calendar month vs. trailing 30 days) and partial-period under-counts.\n\n## Tools\n\n| Tool | What it does | Read-only |\n|---|---|---|\n| `list_workspaces` | Lists every Credible workspace the caller can access, grouped by org. | Yes |\n| `get_context` | Searches a workspace's semantic model for sources, dimensions, measures, views, and dimensional values matching the user's question. | Yes |\n| `execute_query` | Executes a Malloy query (or a predefined view) against the workspace and returns rows + render metadata. | Yes (queries cannot mutate data) |\n| `search_malloy_docs` | Searches the Malloy documentation for syntax, language features, and code examples — used by Claude to look up unfamiliar patterns before writing a query. | Yes |\n\nAll tools are annotated with `readOnlyHint: true` — the plugin cannot write back to your warehouse or your Credible workspace.\n\n## Privacy\n\nSee [PRIVACY.md](./PRIVACY.md) for the full policy. The plugin only shares the OAuth identity, the questions you ask, and the resulting query results with Credible's servers; it does not transmit credentials or warehouse data to any third party other than the LLM provider already mediating the chat. Credible's privacy policy is also published at <https://credibledata.com/privacy>.\n\n## Support\n\n- **Docs**: <https://docs.credibledata.com>\n- **Email**: support@credibledata.com\n- **Issues** (this plugin): <https://github.com/credibledata/credible-plugin/issues>\n\n## License\n\nSee [LICENSE](./LICENSE).\n",
  "bytes": 6278,
  "sha": "896678ff2c0bdf7e54d9cf0cd020109d4085cdf0b31bd9807d3e3478530ad806",
  "repo_slug": "credibledata/credible-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_credibledata_credible_plugin_credible_6e00f0a0/readme"
}