Orderful MCP tools
What each Orderful MCP tool does, when your assistant uses it, and what to ask.
Each tool has its own section. Your AI assistant reads these when it follows the link in a tool description. To connect, see Orderful MCP.
All of these tools look things up. They show you what is in your Orderful account and never change it. More tools, for onboarding, discovery and integration help, are on the way.
Contents
| Group | Tool | What it does |
|---|---|---|
| Troubleshooting | list_transactions | Finds transactions by type, partner, status, stream and date. |
| Troubleshooting | get_transaction_detail | Explains why a transaction failed, or what happened to it: errors, delivery, rules and filtering. |
| Troubleshooting | list_partnerships | Lists your trading partnerships with their status. |
| Troubleshooting | get_partnership_detail | Shows where a partnership stands, what's still open and what blocks go-live. |
| Troubleshooting | list_relationships | Lists the relationships you have with partners, per transaction type and direction. |
| Troubleshooting | get_relationship_detail | Shows how one relationship is configured: guideline, channel, validation and filtering. |
| Admin visibility | list_audit_logs | Lists recent changes in your organization: who changed what, and through which AI client. |
Troubleshooting
list_transactions
Finds transactions by type, partner, status, stream and date.
Use it when
- You want to find transactions before looking at one in detail
Don't use it when
- Getting errors or message contents. Use
get_transaction_detailinstead.
What you get
A page of results, and a statement if the list was cut short.
Good to know
- It returns metadata only, never the message body.
- It returns up to 50 results per request and says if the list was cut short.
- Acknowledgment status is from your point of view. Overdue on an inbound document means you haven't acknowledged it, not the partner.
Try asking
- "Show failed 850s from Acme this week."
- "Which live invoices are still pending?"
If something goes wrong
- "'VALUE' isn't a valid FIELD. Valid values: LIST."
- "No transactions match: FILTERS."
- "Showing the first N of more. Narrow by date, partner or status to see the rest."
get_transaction_detail
Explains why a transaction failed, or what happened to it: errors, delivery, rules and filtering.
Use it when
- You ask why something failed
- You ask what happened to a transaction
Don't use it when
- Listing or finding transactions. Use
list_transactionsinstead.
What you get
Details, errors and a link in the Orderful app.
Good to know
- The message body is included, so responses can be large.
- A rule or guideline filter can remove data between send and validation. If an error contradicts the message, check for that first.
- It says who can fix the issue: you, the partner or Orderful.
Try asking
- "Why did transaction 123456 fail?"
- "What happened to this order? Paste an Orderful link."
If something goes wrong
- "Nothing found with that ID in your organization. Check the ID or paste the link from Orderful."
- "Part of this couldn't be loaded: PART. The rest is shown."
- "The transaction is marked invalid but no errors were recorded."
list_partnerships
Lists your trading partnerships with their status.
Use it when
- You ask who you trade with
- You want a one-line status per partner
Don't use it when
- Tasks or blockers on one partnership. Use
get_partnership_detailinstead.
What you get
Your partnerships and their status.
Good to know
- It pages through all of your partnerships, not just the first few.
Try asking
- "Who do we trade with?"
- "Which partnerships are live?"
If something goes wrong
- "No partnerships match: FILTERS."
- "Showing N partnerships. Use
next_cursorto get the next page."
get_partnership_detail
Shows where a partnership stands, what's still open and what blocks go-live.
Use it when
- You ask where a partner stands
- You want to know what is blocking go-live
Don't use it when
- You don't have the partnership or partner name. Use
list_partnershipsfirst. - A one-line status for several partnerships. Use
list_partnershipsinstead.
What you get
The partnership's status and open tasks.
Good to know
list_partnershipsalready returns status. Use this tool for tasks and blockers on one partnership.- No open tasks doesn't mean the partnership is live.
Try asking
- "Where do we stand with Acme?"
- "What's blocking go-live with Acme?"
If something goes wrong
- "Nothing found with that partnership ID in your organization."
- "No open tasks. This doesn't mean the partnership is live."
list_relationships
Lists the relationships you have with partners, per transaction type and direction.
Use it when
- You want to find which relationship applies
Don't use it when
- You want the settings of one relationship. Use
get_relationship_detailinstead.
What you get
Relationships with both sides' IDs.
Good to know
- Each relationship appears once per direction, from the owner's side.
- You can filter by status: blocked, pending, setup, test, ready or live.
Try asking
- "Which relationships with Acme are still in test?"
- "List our live outbound 850s."
If something goes wrong
- "No relationships match: FILTERS."
- "Showing the first N of more. Narrow the filters to see the rest."
get_relationship_detail
Shows how one relationship is configured: guideline, channel, validation and filtering.
Use it when
- A configuration question comes up while troubleshooting
Don't use it when
- You don't have the relationship ID. Use
list_relationshipsfirst.
What you get
The relationship's settings in plain language.
Good to know
- It says when a setting isn't available instead of guessing.
Try asking
- "How is our 850 with Acme set up?"
- "Which guideline is assigned to this relationship?"
If something goes wrong
- "Nothing found with that ID in your organization. Use list_relationships to find it."
- "SETTING isn't available for this relationship."
Admin visibility
list_audit_logs
Lists recent changes in your organization: who changed what, and through which AI client.
Use it when
- You want to see who changed what, and through which AI client
What you get
Recent audit entries.
Good to know
- Combine all filters in one call. Different filters narrow the result, and several values of one filter widen it.
- The total stops at 1,000 and the tool says 1,000 or more.
- For events across two organizations, users from the partner side appear by organization name only.
Try asking
- "What changed on our Acme relationships this week?"
- "Show changes made through AI clients."
If something goes wrong
- "'VALUE' isn't a valid action type. Valid values: LIST."
- "1,000 or more entries match. Narrow the dates or filters."
Updated 4 days ago

