Skip to content

Update from code changes: async AI writeback MCP tools#970

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/3e4f1ff1
Open

Update from code changes: async AI writeback MCP tools#970
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/3e4f1ff1

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Document the breaking change to the MCP run_ai_writeback tool (now async) and the new get_ai_writeback_status polling tool.

Changes

  • Added an Editing the dbt project section to the MCP tools reference covering run_ai_writeback and get_ai_writeback_status: parameters, response shapes, a polling example, and a warning flagging the breaking change to the run_ai_writeback response shape.
  • Noted that polling has no session affinity (any authorized client can poll a run) and that the in-product chat card is unaffected.
  • Softened the "synchronous" wording in the AI writeback guide and pointed external MCP clients at the new reference section.

Context

Source: lightdash/lightdash#25297run_ai_writeback now returns { aiWritebackRunUuid } immediately and callers poll get_ai_writeback_status for the terminal result, so long-running writebacks no longer die on MCP transport idle timeouts and naive retries can't open duplicate PRs.

@mintlify

mintlify Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Jul 10, 2026, 1:01 AM

@github-actions

github-actions Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant