docs: add creative agent setup verification#5881
Conversation
There was a problem hiding this comment.
The automated review encountered an issue (possibly reached max turns, timed out, or failed to post the final gh pr review). A human reviewer should take this PR.
This is an automated message from the Argus AI review workflow.
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 089723774b
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| curl -X POST "$AGENT_URL" \ | ||
| -H "Content-Type: application/json" \ | ||
| -H "Accept: application/json, text/event-stream" \ | ||
| -d '{ | ||
| "jsonrpc": "2.0", | ||
| "id": 1, | ||
| "method": "tools/call", |
There was a problem hiding this comment.
Initialize MCP sessions before probing tools
For MCP endpoints that implement the standard lifecycle or return an Mcp-Session-Id, this raw tools/call as the first request will be rejected or run before capabilities are negotiated; the MCP lifecycle spec says initialization is the first interaction and Streamable HTTP clients must carry the returned session ID on subsequent requests (see https://modelcontextprotocol.io/specification/2025-03-26/basic/lifecycle#initialization and https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#session-management). Since this is presented as the runnable deployment check for remote MCP creative agents, compliant stateful servers can appear broken. Add the initialize/initialized handshake and session header steps, or point readers to an MCP client/CLI that performs them.
Useful? React with 👍 / 👎.
Summary
creative.supported_formatsget_adcp_capabilitiesconnectivity probeWhy
Creative-agent implementers and buyers have no runnable setup check in the deployment guide. The new probe verifies endpoint reachability and the canonical creative-format discovery surface without depending on a specific vendor or the deprecated
list_creative_formatsdiscovery path.Closes #5877.
Validation
node tests/snippet-validation.test.cjs --file docs/creative/implementing-creative-agents.mdxnode tests/docs-nav-validation.test.cjsnpm run check:seo(passed with existing repository warnings)git diff --checkNo changeset: documentation-only, non-normative addition.