KEYXE Developer Center · MCP

Understand the Tools Before You Use Them.

These public tool examples are read-only and run in your browser against synthetic data. Inspect their schemas, try the examples and copy the JSON. Production MCP connections and account permissions are configured in the KEYXE application.

Try the tools Download catalog JSON

Sample-data preview

Try the tools

Browser-local simulator. Running a tool performs no network request; results are synthetic and carry "is_live_amazon_data": false.

`analytics_query`

Runs a whitelisted aggregate query (no free-form SQL). Validates dataset, metrics, grouping, marketplace, date range and limit.

Demo only

Auth: Demo: none. Future production: scoped read permission per dataset.
Error codes: INVALID_ARGUMENTUNSUPPORTED_METRICUNSUPPORTED_GROUPINGINVALID_DATE_RANGE

Run the tool to see a JSON-RPC request and response. Nothing leaves your browser.

`accounts_list`

Demo only — live Amazon connections await approval

Lists the fictional demo connections. In the demo, no real Amazon account is ever connected.

Read-only: Yes
Auth requirement: Demo: none. Future production: KEYXE login + organization scope.
Error codes: INVALID_ARGUMENT

Try example in the demo

accounts_list · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "kind": {
      "default": "all",
      "type": "string",
      "enum": [
        "all",
        "sp_api_seller",
        "ads_api_profile"
      ]
    }
  },
  "additionalProperties": false
}

arguments

{
  "kind": "all"
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "accounts_list",
  "request_id": "demo-req-000001",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": null,
  "currency": null,
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made.",
    "These are fictional demo connections. No Amazon account is connected."
  ],
  "result": {
    "accounts": [
      {
        "account_id": "demo-seller-001",
        "kind": "sp_api_seller",
        "label": "Demo Seller Account (fictional)",
        "marketplaces": [
          "US",
          "CA",
          "UK",
          "DE"
        ],
        "connection_status": "demo_only",
        "live": false
      },
      {
        "account_id": "demo-ads-profile-us",
        "kind": "ads_api_profile",
        "label": "Demo Advertiser Profile · US (fictional)",
        "marketplaces": [
          "US"
        ],
        "connection_status": "demo_only",
        "live": false
      },
      {
        "account_id": "demo-ads-profile-ca",
        "kind": "ads_api_profile",
        "label": "Demo Advertiser Profile · CA (fictional)",
        "marketplaces": [
          "CA"
        ],
        "connection_status": "demo_only",
        "live": false
      },
      {
        "account_id": "demo-ads-profile-uk",
        "kind": "ads_api_profile",
        "label": "Demo Advertiser Profile · UK (fictional)",
        "marketplaces": [
          "UK"
        ],
        "connection_status": "demo_only",
        "live": false
      },
      {
        "account_id": "demo-ads-profile-de",
        "kind": "ads_api_profile",
        "label": "Demo Advertiser Profile · DE (fictional)",
        "marketplaces": [
          "DE"
        ],
        "connection_status": "demo_only",
        "live": false
      }
    ],
    "count": 5
  }
}

`datasets_search`

Demo only

Finds sample datasets by keyword and source category.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: INVALID_ARGUMENT

Try example in the demo

datasets_search · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "type": "string",
      "maxLength": 100
    },
    "source": {
      "default": "all",
      "type": "string",
      "enum": [
        "all",
        "seller",
        "advertising",
        "inventory"
      ]
    }
  },
  "additionalProperties": false
}

arguments

{
  "query": "acos",
  "source": "all"
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "datasets_search",
  "request_id": "demo-req-000002",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": null,
  "currency": null,
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made."
  ],
  "result": {
    "datasets": [
      {
        "id": "sample_ads_campaign_daily",
        "title": "Sample advertising campaigns (daily)",
        "source": "advertising",
        "grain": "one row per campaign × day",
        "description": "Fictional impressions, clicks, spend and attributed sales for sample campaigns."
      }
    ],
    "count": 1
  }
}

`dataset_schema_get`

Demo only

Returns column names, types and the permission a production equivalent would need.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: INVALID_ARGUMENT

Try example in the demo

dataset_schema_get · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "enum": [
        "sample_seller_sales_daily",
        "sample_ads_campaign_daily",
        "sample_inventory_daily"
      ]
    }
  },
  "required": [
    "dataset"
  ],
  "additionalProperties": false
}

arguments

{
  "dataset": "sample_ads_campaign_daily"
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "dataset_schema_get",
  "request_id": "demo-req-000003",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": null,
  "currency": null,
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made."
  ],
  "result": {
    "dataset": "sample_ads_campaign_daily",
    "grain": "one row per campaign × day",
    "columns": [
      {
        "name": "date",
        "type": "date",
        "description": "Calendar day (sample)"
      },
      {
        "name": "campaign",
        "type": "string",
        "description": "Sample campaign name"
      },
      {
        "name": "format",
        "type": "string",
        "description": "Sponsored Products, Sponsored Brands or Sponsored Display (sample)"
      },
      {
        "name": "impressions",
        "type": "integer",
        "description": "Ad impressions"
      },
      {
        "name": "clicks",
        "type": "integer",
        "description": "Ad clicks"
      },
      {
        "name": "spend",
        "type": "decimal",
        "description": "Ad spend, local currency"
      },
      {
        "name": "attributed_sales",
        "type": "decimal",
        "description": "Sales attributed to ads, local currency"
      },
      {
        "name": "orders",
        "type": "integer",
        "description": "Attributed orders"
      },
      {
        "name": "ctr",
        "type": "ratio",
        "description": "clicks ÷ impressions"
      },
      {
        "name": "cpc",
        "type": "decimal",
        "description": "spend ÷ clicks"
      },
      {
        "name": "acos",
        "type": "ratio",
        "description": "spend ÷ attributed sales"
      },
      {
        "name": "roas",
        "type": "ratio",
        "description": "attributed sales ÷ spend"
      }
    ],
    "queryable_metrics": [
      "impressions",
      "clicks",
      "spend",
      "attributed_sales",
      "orders",
      "ctr",
      "cpc",
      "acos",
      "roas"
    ],
    "group_by_options": [
      "campaign",
      "format"
    ],
    "coverage": {
      "start": "2026-04-04",
      "end": "2026-09-30"
    },
    "required_permission": "demo:read (synthetic, no login)",
    "production_equivalent": "Would require Amazon Ads API access and advertiser authorization. Not available."
  }
}

`analytics_query`

Demo only

Runs a whitelisted aggregate query (no free-form SQL). Validates dataset, metrics, grouping, marketplace, date range and limit.

Read-only: Yes
Auth requirement: Demo: none. Future production: scoped read permission per dataset.
Error codes: INVALID_ARGUMENT, UNSUPPORTED_METRIC, UNSUPPORTED_GROUPING, INVALID_DATE_RANGE

Try example in the demo

analytics_query · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "enum": [
        "sample_seller_sales_daily",
        "sample_ads_campaign_daily",
        "sample_inventory_daily"
      ]
    },
    "metrics": {
      "minItems": 1,
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "group_by": {
      "type": "string"
    },
    "marketplace": {
      "default": "US",
      "type": "string",
      "enum": [
        "US",
        "CA",
        "UK",
        "DE"
      ],
      "description": "Sample marketplace code"
    },
    "date_range": {
      "default": {
        "preset": "30d"
      },
      "type": "object",
      "properties": {
        "preset": {
          "default": "30d",
          "type": "string",
          "enum": [
            "7d",
            "30d",
            "90d",
            "custom"
          ]
        },
        "start": {
          "description": "YYYY-MM-DD, on or after 2026-04-04",
          "type": "string"
        },
        "end": {
          "description": "YYYY-MM-DD, on or before 2026-09-30",
          "type": "string"
        }
      }
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "sort_direction": {
      "default": "desc",
      "type": "string",
      "enum": [
        "desc",
        "asc"
      ]
    }
  },
  "required": [
    "dataset",
    "metrics"
  ],
  "additionalProperties": false
}

arguments

{
  "dataset": "sample_ads_campaign_daily",
  "metrics": [
    "spend",
    "attributed_sales",
    "acos"
  ],
  "group_by": "campaign",
  "marketplace": "US",
  "date_range": {
    "preset": "30d"
  },
  "limit": 5
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "analytics_query",
  "request_id": "demo-req-000004",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": "US",
  "currency": "USD",
  "as_of": "2026-10-01T00:00:00Z",
  "units": "Money in major units of the marketplace currency; ratios as decimals (0.25 = 25%).",
  "attribution": "Sample attributed sales/orders use a fictional attribution window. Not comparable to seller ordered sales.",
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made.",
    "Showing 5 of 36 grouped rows (limit 5)."
  ],
  "result": {
    "dataset": "sample_ads_campaign_daily",
    "period": {
      "start": "2026-09-01",
      "end": "2026-09-30",
      "days": 30
    },
    "group_by": "campaign",
    "rows": [
      {
        "campaign": "Demo SP · Office · Automatic targeting · 13",
        "spend": 4133.95,
        "attributed_sales": 8957.03,
        "acos": 0.4615
      },
      {
        "campaign": "Demo SP · Home Storage · Exact keywords · 32",
        "spend": 2893.41,
        "attributed_sales": 7817.09,
        "acos": 0.3701
      },
      {
        "campaign": "Demo SP · Fitness · Phrase keywords · 10",
        "spend": 2553.25,
        "attributed_sales": 6285.09,
        "acos": 0.4062
      },
      {
        "campaign": "Demo SP · Home Storage · Product targets · 01",
        "spend": 2483.04,
        "attributed_sales": 5555.5,
        "acos": 0.447
      },
      {
        "campaign": "Demo SB · Lighting · Sample Brand A · phrase keywords · 14",
        "spend": 2376.42,
        "attributed_sales": 5784.13,
        "acos": 0.4109
      }
    ],
    "row_count": 5,
    "total_groups": 36
  }
}

`reports_create`

Demo only (simulated job)

Creates a simulated report job in this browser tab. No file leaves your browser and no network call is made.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: INVALID_ARGUMENT, INVALID_DATE_RANGE

Try example in the demo

reports_create · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "enum": [
        "sample_seller_sales_daily",
        "sample_ads_campaign_daily",
        "sample_inventory_daily"
      ]
    },
    "marketplace": {
      "default": "US",
      "type": "string",
      "enum": [
        "US",
        "CA",
        "UK",
        "DE"
      ],
      "description": "Sample marketplace code"
    },
    "date_range": {
      "default": {
        "preset": "30d"
      },
      "type": "object",
      "properties": {
        "preset": {
          "default": "30d",
          "type": "string",
          "enum": [
            "7d",
            "30d",
            "90d",
            "custom"
          ]
        },
        "start": {
          "description": "YYYY-MM-DD, on or after 2026-04-04",
          "type": "string"
        },
        "end": {
          "description": "YYYY-MM-DD, on or before 2026-09-30",
          "type": "string"
        }
      }
    },
    "format": {
      "default": "csv",
      "type": "string",
      "enum": [
        "csv",
        "json"
      ]
    }
  },
  "required": [
    "dataset"
  ],
  "additionalProperties": false
}

arguments

{
  "dataset": "sample_seller_sales_daily",
  "marketplace": "US",
  "date_range": {
    "preset": "30d"
  },
  "format": "csv"
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "reports_create",
  "request_id": "demo-req-000005",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": "US",
  "currency": "USD",
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made.",
    "Simulated job held in this browser tab only. Nothing is uploaded or sent."
  ],
  "result": {
    "job_id": "demo-job-0001",
    "status": "queued",
    "dataset": "sample_seller_sales_daily",
    "period": {
      "start": "2026-09-01",
      "end": "2026-09-30"
    },
    "format": "csv"
  }
}

`reports_status_get`

Demo only (simulated job)

Returns the simulated job state. Each check advances queued → processing → completed.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: INVALID_ARGUMENT, NOT_FOUND

Try example in the demo

reports_status_get · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^demo-job-\\d{4}$"
    }
  },
  "required": [
    "job_id"
  ],
  "additionalProperties": false
}

arguments

{
  "job_id": "demo-job-0001"
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "reports_status_get",
  "request_id": "demo-req-000007",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": "US",
  "currency": "USD",
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made."
  ],
  "result": {
    "job_id": "demo-job-0001",
    "status": "processing",
    "dataset": "sample_seller_sales_daily",
    "period": {
      "start": "2026-09-01",
      "end": "2026-09-30"
    },
    "format": "csv",
    "note": "Check again to advance the simulated job."
  }
}

`audit_events_list`

Demo only

Lists demo audit events, including the tool calls you made in this tab.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: INVALID_ARGUMENT

Try example in the demo

audit_events_list · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "additionalProperties": false
}

arguments

{
  "limit": 10
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "audit_events_list",
  "request_id": "demo-req-000008",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": null,
  "currency": null,
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made."
  ],
  "result": {
    "events": [
      {
        "event_id": "demo-evt-008",
        "at": "2026-10-01T00:00:08Z",
        "actor": "you (this browser tab)",
        "action": "tool.audit_events_list",
        "detail": "{\"limit\":10}"
      },
      {
        "event_id": "demo-evt-007",
        "at": "2026-10-01T00:00:07Z",
        "actor": "you (this browser tab)",
        "action": "tool.reports_status_get",
        "detail": "{\"job_id\":\"demo-job-0001\"}"
      },
      {
        "event_id": "demo-evt-006",
        "at": "2026-10-01T00:00:06Z",
        "actor": "you (this browser tab)",
        "action": "tool.reports_create",
        "detail": "{\"dataset\":\"sample_seller_sales_daily\",\"marketplace\":\"US\",\"date_range\":{\"preset\":\"30d\"},\"format\":\"csv\"}"
      },
      {
        "event_id": "demo-evt-005",
        "at": "2026-10-01T00:00:05Z",
        "actor": "you (this browser tab)",
        "action": "tool.reports_create",
        "detail": "{\"dataset\":\"sample_seller_sales_daily\",\"marketplace\":\"US\",\"date_range\":{\"preset\":\"30d\"},\"format\":\"csv\"}"
      },
      {
        "event_id": "demo-evt-004",
        "at": "2026-10-01T00:00:04Z",
        "actor": "you (this browser tab)",
        "action": "tool.analytics_query",
        "detail": "{\"dataset\":\"sample_ads_campaign_daily\",\"metrics\":[\"spend\",\"attributed_sales\",\"acos\"],\"group_by\":\"campaign\",\"marketplace\""
      },
      {
        "event_id": "demo-evt-003",
        "at": "2026-10-01T00:00:03Z",
        "actor": "you (this browser tab)",
        "action": "tool.dataset_schema_get",
        "detail": "{\"dataset\":\"sample_ads_campaign_daily\"}"
      },
      {
        "event_id": "demo-evt-002",
        "at": "2026-10-01T00:00:02Z",
        "actor": "you (this browser tab)",
        "action": "tool.datasets_search",
        "detail": "{\"query\":\"acos\",\"source\":\"all\"}"
      },
      {
        "event_id": "demo-evt-001",
        "at": "2026-10-01T00:00:01Z",
        "actor": "you (this browser tab)",
        "action": "tool.accounts_list",
        "detail": "{\"kind\":\"all\"}"
      },
      {
        "event_id": "demo-evt-f01",
        "at": "2026-09-30T16:02:00Z",
        "actor": "demo-analyst (fictional)",
        "action": "report.created",
        "detail": "sample_seller_sales_daily · US · 30d"
      },
      {
        "event_id": "demo-evt-f02",
        "at": "2026-09-30T16:05:00Z",
        "actor": "demo-analyst (fictional)",
        "action": "proposal.drafted",
        "detail": "Bid −10% on a sample keyword target (not sent)"
      }
    ],
    "count": 10,
    "total_available": 11
  }
}

`usage_status_get`

Demo only

Shows how many simulated tool calls were made in this tab.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: None

Try example in the demo

arguments

{}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "usage_status_get",
  "request_id": "demo-req-000009",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": null,
  "currency": null,
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made."
  ],
  "result": {
    "tool_calls_this_tab": 9,
    "report_jobs_this_tab": 2,
    "rate_limit": "Not applicable — the simulator runs entirely in your browser."
  }
}

Understand the Tools Before You Use Them.

Try the tools

analytics_query

Arguments

accounts_list

Input schema (JSON Schema)

Example arguments and output

datasets_search

Input schema (JSON Schema)

Example arguments and output

dataset_schema_get

Input schema (JSON Schema)

Example arguments and output

analytics_query

Input schema (JSON Schema)

Example arguments and output

reports_create

Input schema (JSON Schema)

Example arguments and output

reports_status_get

Input schema (JSON Schema)

Example arguments and output

audit_events_list

Input schema (JSON Schema)

Example arguments and output

usage_status_get

Input schema (JSON Schema)

Example arguments and output

`analytics_query`

`accounts_list`

`datasets_search`

`dataset_schema_get`

`analytics_query`

`reports_create`

`reports_status_get`

`audit_events_list`

`usage_status_get`