MCP troubleshooting
Fix connection problems, wrong-account answers and empty results.
Fix MCP connection, access, and search-result problems by running who_am_i first, then using the symptom tables below.
Run who_am_i first
who_am_i firstwho_am_i takes no arguments and is the most reliable connection check because it performs an authenticated read. It identifies the Account the tools use and the Accounts your connection can access.
Common problems
| Symptom | What is happening |
|---|---|
| No Wingspan tools appear | The plugin is installed but the server is not connected. Check the server connection and make sure you are signed in. |
| Connecting reports that the endpoint cannot be found | The server URL is wrong, or the client rewrote it. Check it against https://api.wingspan.app/v3/mcp. If the URL is right, contact Wingspan support. |
| Every tool starts failing at once | The authorization was revoked, or renewal failed. Authorize the connection again. |
| Answers are about the wrong company | Run who_am_i. If you work with more than one Wingspan account, authorize the one you mean. In an organization with child accounts, name the child account with accountId. |
| A contractor list looks empty | Contractor searches exclude archived contractors unless you ask for them, and a contractor with no engagement assigned has no paperwork status to filter on. |
| A payment list looks empty | Payment searches exclude cancelled payments unless you ask for them. |
| A total looks wrong | Check which view it covers. all includes paid, in-transit, off-platform and refunded payments, so it is the wrong view for what you owe. See Totals. |
| The assistant says a record does not exist | A record belonging to a different account reads as not found, on purpose. Confirm the account with who_am_i. |
What the error messages mean
| Tool response | Meaning |
|---|---|
| Not a well-formed id | The id is the wrong shape. Use the id a search result carried, not one copied from a spreadsheet, a URL or another system. |
| Not found | No such record is visible to this account. |
| Invalid request | The arguments contradict each other. The message says which pair. |
| The token was rejected | The authorization is no longer accepted. Reauthorize the MCP connection. |
Still stuck
Contact your Wingspan account team, or reach Wingspan support from the Help menu in the Wingspan app. Include the request id if a tool gave you one.
Updated 13 days ago
Did this page help you?