docs: align MCP tool reference with live schemas - #361
Conversation
Co-authored-by: Akshay Dodeja <dodeja@gmail.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
Co-authored-by: Akshay Dodeja <dodeja@gmail.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 2ccefaabd6
ℹ️ 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".
| **Parameters** | ||
| - `filters` *(object, optional)* – raw query filters | ||
| - `request_number` *(string, optional)* – tracking request identifier | ||
| - `status` *(string, optional)* – `created`, `pending`, `succeeded`, or `failed` |
There was a problem hiding this comment.
succeeded status
When a caller follows this reference and passes status: "succeeded", list_tracking_requests forwards it unchanged as filter[status], but the OpenAPI filter permits only created, pending, and failed, and the tracking-request model has no succeeded state. tracking_request.succeeded is a webhook event; successful requests use created, so this value cannot retrieve the promised records and may be rejected by the API. Remove it from the documented statuses, or update the underlying API/tool contract before advertising it.
AGENTS.md reference: AGENTS.md:L23-L27
Useful? React with 👍 / 👎.
2 participants
Summary
list_shipments,list_containers, andlist_tracking_requestsparameters with the live MCP schemasget_containertransport-event summary fields and point toget_container_transport_eventsfor the full timeline_metadata, such asincludes_loaded, may remain in responsestrack_container.numberas requiredVerification
mainafter API#360 and the livemcpdemoresponsegit diff --checkLinear: DEV-12451
Need help on this PR? Tag
@codesmith-botwith what you need. Autofix is disabled.