Account tools
Connectivity check, account info, and pinned API version control.
These tools let an agent introspect what merchant it’s talking to and (rarely) upgrade the merchant’s pinned API version.
Tools
ping
Verify connectivity. Returns a small JSON object confirming the account.
| Annotation | Value |
|---|---|
| readOnlyHint | true |
| destructiveHint | false |
| idempotentHint | true |
| openWorldHint | false |
Use it as the first thing any agent run does — fast smoke test that the key, transport, and version are all working.
get_account
Return the current merchant account (id, name, default currency, pinned API version, environment).
| Annotation | Value |
|---|---|
| readOnlyHint | true |
| destructiveHint | false |
| idempotentHint | true |
| openWorldHint | false |
upgrade_account_api_version
Change the merchant’s pinned API version to a newer date. One-way, irreversible — you cannot pin back to an older version through the API.
| Annotation | Value |
|---|---|
| readOnlyHint | false |
| destructiveHint | true |
| idempotentHint | true |
| openWorldHint | false |
Always read the changelog and test the new version in sandbox before calling this in live mode. A well-built MCP client should require explicit human confirmation here — destructiveHint: true.