Amazon Selling Partner API
Amazon Seller: connection status MCP
Get the saved status and revision of an owned Amazon Seller connection. Use the revision when confirming a connection disconnect.
Amazon Seller: connection status AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Review The Documented Amazon Seller: Connection Status Operation
Prompt: Review the documented Amazon Seller: connection status operation using connection ID [CONNECTION_ID]. Summarize only the returned evidence and keep missing values explicit.
What You Need to Provide
Provide connection ID [CONNECTION_ID]. Follow the Arguments section for accepted formats, limits and conditional inputs.
Missing results remain unavailable. Multiple targets or time windows can require multiple calls; do not infer trends from a single snapshot.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_amazon_sp_api_auth_connection_statushttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "amazon-sp-api-auth-connection-status-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_sp_api_auth_connection_status",
"arguments": {
"connectionId": 123
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
connectionId | integer | required | Owned Seller connection ID. Example: 123 |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
data | any | required | Data value used by this API operation. |
msg | string | null | required | Msg value used by this API operation. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
traceId | string | null | required | Trace id value used by this API operation. |
ts | string | required | Epoch milliseconds. |
Any of option 1 — requires connection
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.connection | object | required | Seller connection metadata including status and revision. Example: {} |
data.costTime | any | optional | Execution time reported by the upstream provider. |
data.costToken | any | optional | Token cost reported by the upstream provider. |
data.dataSnapshotMonth | any | optional | Data snapshot month returned by the upstream provider. |
data.page | any | optional | Current page returned by the upstream provider. |
data.pageItemCount | any | optional | Item count on the current page returned by the upstream provider. |
data.pageSize | any | optional | Page size returned by the upstream provider. |
data.sourceTool | any | optional | Provider-specific source tool name. |
data.sourceType | any | optional | Provider-specific source platform type. |
data.title | any | optional | Provider-specific response title. |
data.totalPage | any | optional | Total page count returned by the upstream provider. |
data.type | any | optional | Provider-specific render or payload type. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.costTime | null | optional | Execution time reported by the upstream provider. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.costToken | integer | optional | Token cost reported by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.costToken | null | optional | Token cost reported by the upstream provider. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.dataSnapshotMonth | null | optional | Data snapshot month returned by the upstream provider. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.page | null | optional | Current page returned by the upstream provider. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.pageItemCount | null | optional | Item count on the current page returned by the upstream provider. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.pageSize | null | optional | Page size returned by the upstream provider. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceTool | null | optional | Provider-specific source tool name. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceType | null | optional | Provider-specific source platform type. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.title | string | optional | Provider-specific response title. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.title | null | optional | Provider-specific response title. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.totalPage | null | optional | Total page count returned by the upstream provider. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.type | string | optional | Provider-specific render or payload type. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.type | null | optional | Provider-specific render or payload type. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Example Q&A
A verified answer example is not available for this tool. Review the documented parameters and use Online Test to obtain a result with your own inputs.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"connectionId": 123
}Response
{
"code": 0,
"data": {
"connection": {
"id": 123,
"marketplaceId": "ATVPDKIKX0DER",
"region": "NA",
"status": "CONNECTED",
"revision": 2
}
}
}View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "amazon-sp-api-auth-connection-status-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_sp_api_auth_connection_status",
"arguments": {
"connectionId": 123
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "amazon-sp-api-auth-connection-status-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"data\":{\"connection\":{\"id\":123,\"marketplaceId\":\"ATVPDKIKX0DER\",\"region\":\"NA\",\"status\":\"CONNECTED\",\"revision\":2}}}"
}
],
"structuredContent": {
"code": 0,
"data": {
"connection": {
"id": 123,
"marketplaceId": "ATVPDKIKX0DER",
"region": "NA",
"status": "CONNECTED",
"revision": 2
}
}
},
"isError": false
}
}