{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "returngo.usefulapi.io",
    "site": "usefulapi.io",
    "addresses": [
      {
        "address": "104.21.62.184",
        "endpoints": 756,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.32.0/19",
          "country": "US"
        }
      },
      {
        "address": "172.67.138.37",
        "endpoints": 756,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.128.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3030::ac43:8a25",
        "endpoints": 756,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3030::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3032::6815:3eb8",
        "endpoints": 756,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3032::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "104.21.62.184",
          "172.67.138.37",
          "2606:4700:3030::ac43:8a25",
          "2606:4700:3032::6815:3eb8"
        ],
        "first_seen": "2026-11-22T19:18:01.892Z",
        "last_seen": "2026-11-22T19:18:01.892Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "returngo-mcp",
      "version": "1.1.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 755,
      "sample": [
        {
          "id": "22186",
          "url": "https://mcp.easyscribe.guide/mcp",
          "server_name": "guide.easyscribe/easy-scribe",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T17:59:02.319Z"
        },
        {
          "id": "42087",
          "url": "https://17track.usefulapi.io/mcp",
          "server_name": "io.usefulapi/17track",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:10:01.976Z"
        },
        {
          "id": "42088",
          "url": "https://a2x-accounting.usefulapi.io/mcp",
          "server_name": "io.usefulapi/a2x-accounting",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:11:01.183Z"
        },
        {
          "id": "42089",
          "url": "https://abacus-pos.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abacus-pos",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:12:01.080Z"
        },
        {
          "id": "42090",
          "url": "https://abaninja.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abaninja",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:13:02.135Z"
        },
        {
          "id": "42091",
          "url": "https://ablesign.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ablesign",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:14:01.432Z"
        },
        {
          "id": "42092",
          "url": "https://ably.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ably",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:15:01.611Z"
        },
        {
          "id": "42093",
          "url": "https://abra-flexi.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abra-flexi",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:16:00.986Z"
        },
        {
          "id": "42094",
          "url": "https://absence-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/absence-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:17:01.057Z"
        },
        {
          "id": "42095",
          "url": "https://abstract-api.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abstract-api",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:18:00.734Z"
        },
        {
          "id": "42096",
          "url": "https://academy-of-mine.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academy-of-mine",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:19:00.968Z"
        },
        {
          "id": "42097",
          "url": "https://academyocean.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academyocean",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:20:01.024Z"
        },
        {
          "id": "42098",
          "url": "https://accelo.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accelo",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:21:01.299Z"
        },
        {
          "id": "42099",
          "url": "https://accredible.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accredible",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:22:00.819Z"
        },
        {
          "id": "42100",
          "url": "https://action1.usefulapi.io/mcp",
          "server_name": "io.usefulapi/action1",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:23:00.761Z"
        },
        {
          "id": "42101",
          "url": "https://acube.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acube",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:24:00.644Z"
        },
        {
          "id": "42102",
          "url": "https://acuity-scheduling.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acuity-scheduling",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:25:02.340Z"
        },
        {
          "id": "42103",
          "url": "https://adafruit-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adafruit-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:26:02.127Z"
        },
        {
          "id": "42104",
          "url": "https://addevent.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addevent",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:27:01.202Z"
        },
        {
          "id": "42105",
          "url": "https://addressfinder.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addressfinder",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:28:00.709Z"
        }
      ]
    },
    "same_site": {
      "total": 1096,
      "sample": [
        {
          "id": "42087",
          "url": "https://17track.usefulapi.io/mcp",
          "server_name": "io.usefulapi/17track",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:10:01.976Z"
        },
        {
          "id": "42088",
          "url": "https://a2x-accounting.usefulapi.io/mcp",
          "server_name": "io.usefulapi/a2x-accounting",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:11:01.183Z"
        },
        {
          "id": "42089",
          "url": "https://abacus-pos.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abacus-pos",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:12:01.080Z"
        },
        {
          "id": "42090",
          "url": "https://abaninja.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abaninja",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:13:02.135Z"
        },
        {
          "id": "42091",
          "url": "https://ablesign.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ablesign",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:14:01.432Z"
        },
        {
          "id": "42092",
          "url": "https://ably.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ably",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:15:01.611Z"
        },
        {
          "id": "42093",
          "url": "https://abra-flexi.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abra-flexi",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:16:00.986Z"
        },
        {
          "id": "42094",
          "url": "https://absence-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/absence-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:17:01.057Z"
        },
        {
          "id": "42095",
          "url": "https://abstract-api.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abstract-api",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:18:00.734Z"
        },
        {
          "id": "42096",
          "url": "https://academy-of-mine.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academy-of-mine",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:19:00.968Z"
        },
        {
          "id": "42097",
          "url": "https://academyocean.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academyocean",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:20:01.024Z"
        },
        {
          "id": "42098",
          "url": "https://accelo.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accelo",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:21:01.299Z"
        },
        {
          "id": "42099",
          "url": "https://accredible.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accredible",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:22:00.819Z"
        },
        {
          "id": "42100",
          "url": "https://action1.usefulapi.io/mcp",
          "server_name": "io.usefulapi/action1",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:23:00.761Z"
        },
        {
          "id": "42101",
          "url": "https://acube.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acube",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:24:00.644Z"
        },
        {
          "id": "42102",
          "url": "https://acuity-scheduling.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acuity-scheduling",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:25:02.340Z"
        },
        {
          "id": "42103",
          "url": "https://adafruit-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adafruit-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:26:02.127Z"
        },
        {
          "id": "42104",
          "url": "https://addevent.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addevent",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:27:01.202Z"
        },
        {
          "id": "42105",
          "url": "https://addressfinder.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addressfinder",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:28:00.709Z"
        },
        {
          "id": "42106",
          "url": "https://adminpulse.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adminpulse",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:29:00.620Z"
        }
      ]
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.usefulapi",
      "total": 1096,
      "sample": [
        {
          "name": "io.usefulapi/17track",
          "title": "17TRACK MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/a2x-accounting",
          "title": "A2X MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abacus-pos",
          "title": "Abacus POS MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abaninja",
          "title": "AbaNinja MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ablesign",
          "title": "AbleSign MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ably",
          "title": "Ably MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abra-flexi",
          "title": "ABRA Flexi MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/absence-io",
          "title": "absence.io MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abstract-api",
          "title": "Abstract API MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academy-of-mine",
          "title": "Academy of Mine MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academyocean",
          "title": "AcademyOcean MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accelo",
          "title": "Accelo MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accredible",
          "title": "Accredible MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/action1",
          "title": "Action1 MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acube",
          "title": "A-Cube MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acuity-scheduling",
          "title": "Acuity Scheduling MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adafruit-io",
          "title": "Adafruit IO MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addevent",
          "title": "AddEvent MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addressfinder",
          "title": "Addressfinder MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adminpulse",
          "title": "AdminPulse MCP by usefulapi"
        }
      ]
    },
    "same_repository": {
      "repository_url": "https://github.com/m190/usefulapi-mcp",
      "total": 1096,
      "sample": [
        {
          "name": "io.usefulapi/17track",
          "title": "17TRACK MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/a2x-accounting",
          "title": "A2X MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abacus-pos",
          "title": "Abacus POS MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abaninja",
          "title": "AbaNinja MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ablesign",
          "title": "AbleSign MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ably",
          "title": "Ably MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abra-flexi",
          "title": "ABRA Flexi MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/absence-io",
          "title": "absence.io MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abstract-api",
          "title": "Abstract API MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academy-of-mine",
          "title": "Academy of Mine MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academyocean",
          "title": "AcademyOcean MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accelo",
          "title": "Accelo MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accredible",
          "title": "Accredible MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/action1",
          "title": "Action1 MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acube",
          "title": "A-Cube MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acuity-scheduling",
          "title": "Acuity Scheduling MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adafruit-io",
          "title": "Adafruit IO MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addevent",
          "title": "AddEvent MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addressfinder",
          "title": "Addressfinder MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adminpulse",
          "title": "AdminPulse MCP by usefulapi"
        }
      ]
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "42838",
    "server_name": "io.usefulapi/returngo",
    "url": "https://returngo.usefulapi.io/mcp",
    "host": "returngo.usefulapi.io",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T19:18:01.892Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "f73e7b224b218612261ea5cb5e95f1f0ce866e281644232fa461a378758bf11d",
    "first_listed_at": "2026-11-22T19:18:01.892Z",
    "created_at": "2026-11-21T12:40:13.675Z",
    "resolved_addresses": [
      "104.21.62.184",
      "172.67.138.37",
      "2606:4700:3030::ac43:8a25",
      "2606:4700:3032::6815:3eb8"
    ]
  },
  "server": {
    "name": "io.usefulapi/returngo",
    "title": "ReturnGO MCP by usefulapi",
    "description": "Read return requests, refunds and shipments; set RMA status and add comments in ReturnGO.",
    "version": "1.1.0",
    "registry_status": "active",
    "repository_url": "https://github.com/m190/usefulapi-mcp",
    "website_url": "https://usefulapi.io/returngo/",
    "published_at": "2026-11-21T01:02:34.078Z",
    "updated_at": "2026-11-21T01:02:34.078Z",
    "first_seen": "2026-11-21T12:40:13.023Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T19:18:09.707Z"
  },
  "operator": {
    "key": "usefulapi.io",
    "name": "usefulapi.io",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 227,
    "first_check_in_window": "2026-11-22T19:18:01.892Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "f73e7b224b218612261ea5cb5e95f1f0ce866e281644232fa461a378758bf11d",
    "tools": 9,
    "resources": 0,
    "prompts": 6,
    "first_seen": "2026-11-22T19:18:02.149Z",
    "tool_names": [
      "returngo_list_rmas",
      "returngo_get_rma",
      "returngo_list_transactions",
      "returngo_list_webhooks",
      "returngo_track_shipment",
      "returngo_set_shipment",
      "returngo_add_rma_comment",
      "returngo_set_rma_status",
      "returngo_update_transaction"
    ],
    "declared": {
      "tools": [
        {
          "name": "returngo_list_rmas",
          "title": "List RMAs",
          "description": "List and search return requests (RMAs) for the store. Filter by status, creation or update time, order names, tracking numbers or customer ids. Use the returned cursor to page. ReturnGO API: GET /rmas.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "cursor": {
                "type": "string",
                "description": "Cursor from a previous response, to get the next page."
              },
              "status": {
                "type": "string",
                "description": "Comma-separated RMA statuses: Pending, Approved, Received, Validated, Done, Rejected, Canceled."
              },
              "sort_by": {
                "type": "string",
                "description": "Sort columns: rma_created_at or rma_updated_at, prefix - for descending or + for ascending, comma separated. E.g. -rma_created_at."
              },
              "pagesize": {
                "type": "integer",
                "maximum": 500,
                "minimum": 1,
                "description": "Results per page, 1 to 500 (default 25)."
              },
              "order_name": {
                "type": "string",
                "description": "Comma-separated order names, e.g. 1001,1002."
              },
              "customer_ids": {
                "type": "string",
                "description": "Comma-separated customer ids."
              },
              "glbe_order_id": {
                "type": "string",
                "description": "Comma-separated Global-e order ids."
              },
              "rma_created_at": {
                "type": "string",
                "description": "Filter on the creation time: operator:ISO datetime. Operators: lt, lte, gt, gte, eq, neq. E.g. gte:2026-01-01T00:00:00."
              },
              "rma_updated_at": {
                "type": "string",
                "description": "Filter on the last update time: operator:ISO datetime. Operators: lt, lte, gt, gte, eq, neq. E.g. gte:2026-01-01T00:00:00."
              },
              "tracking_numbers": {
                "type": "string",
                "description": "Comma-separated tracking numbers."
              }
            }
          },
          "annotations": {
            "title": "List RMAs",
            "readOnlyHint": true
          }
        },
        {
          "name": "returngo_get_rma",
          "title": "Get an RMA",
          "description": "Get one RMA with its items, status, timeline, shipments and transactions. Set includeMedia to include customer-uploaded photos. ReturnGO API: GET /rma/{rmaId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "rmaId"
            ],
            "properties": {
              "rmaId": {
                "type": "string",
                "minLength": 1,
                "description": "The RMA id (from returngo_list_rmas)."
              },
              "includeMedia": {
                "type": "boolean",
                "description": "Include customer media (photos) in the response."
              }
            }
          },
          "annotations": {
            "title": "Get an RMA",
            "readOnlyHint": true
          }
        },
        {
          "name": "returngo_list_transactions",
          "title": "List transactions",
          "description": "List and search refunds, payment authorizations, captures and invoice payments linked to returns. Filter by status, type, processor, RMA or order ids. ReturnGO API: GET /transactions.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "ids": {
                "type": "string",
                "description": "Comma-separated transaction ids."
              },
              "types": {
                "type": "string",
                "description": "Comma-separated transaction types."
              },
              "cursor": {
                "type": "string",
                "description": "Cursor from a previous response, to get the next page."
              },
              "rma_ids": {
                "type": "string",
                "description": "Comma-separated RMA ids."
              },
              "pagesize": {
                "type": "integer",
                "maximum": 500,
                "minimum": 1,
                "description": "Results per page, 1 to 500 (default 25)."
              },
              "statuses": {
                "type": "string",
                "description": "Comma-separated transaction statuses, e.g. Requested,Failed."
              },
              "order_ids": {
                "type": "string",
                "description": "Comma-separated order ids."
              },
              "created_at": {
                "type": "string",
                "description": "Filter on the creation time: operator:ISO datetime. Operators: lt, lte, gt, gte, eq, neq. E.g. gte:2026-01-01T00:00:00."
              },
              "processors": {
                "type": "string",
                "description": "Comma-separated payment processors."
              },
              "updated_at": {
                "type": "string",
                "description": "Filter on the last update time: operator:ISO datetime. Operators: lt, lte, gt, gte, eq, neq. E.g. gte:2026-01-01T00:00:00."
              }
            }
          },
          "annotations": {
            "title": "List transactions",
            "readOnlyHint": true
          }
        },
        {
          "name": "returngo_list_webhooks",
          "title": "List webhooks",
          "description": "List the webhooks registered for the store, with their event subscriptions and target URLs. ReturnGO API: GET /webhooks.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "List webhooks",
            "readOnlyHint": true
          }
        },
        {
          "name": "returngo_track_shipment",
          "title": "Track a shipment",
          "description": "Get the current tracking status of a return shipment after it was created. Give the shipment id, creation date, order id, destination zip and tracking number. ReturnGO API: POST /shipment-tracker.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "shipmentId",
              "shipmentCreationDate",
              "orderId",
              "destinationZip",
              "trackingNumber"
            ],
            "properties": {
              "orderId": {
                "type": "string",
                "minLength": 1,
                "description": "The order id."
              },
              "lineItems": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Line item ids of the order, as used on the e-commerce platform."
              },
              "shipmentId": {
                "type": "string",
                "minLength": 1,
                "description": "The shipment id."
              },
              "carrierName": {
                "type": "string",
                "description": "Carrier name, if known."
              },
              "trackingUrl": {
                "type": "string",
                "description": "Carrier tracking URL, if known."
              },
              "destinationZip": {
                "type": "string",
                "minLength": 1,
                "description": "Destination postal code."
              },
              "trackingNumber": {
                "type": "string",
                "minLength": 1,
                "description": "The carrier tracking number."
              },
              "shipmentCreationDate": {
                "type": "string",
                "minLength": 1,
                "description": "When the shipment was created, e.g. 2026-11-01."
              }
            }
          },
          "annotations": {
            "title": "Track a shipment",
            "readOnlyHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returngo_set_shipment",
          "title": "Set shipment details",
          "description": "Update the carrier, tracking number, tracking URL, label URL and status of one shipment. All five fields are sent, so pass the current values for the ones you do not change. ReturnGO API: PUT /shipment/{shipmentId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "shipmentId",
              "status",
              "carrierName",
              "trackingNumber",
              "trackingURL",
              "labelURL"
            ],
            "properties": {
              "status": {
                "enum": [
                  "Pending",
                  "LabelCreated",
                  "Shipped",
                  "Received",
                  "Canceled",
                  "Validated"
                ],
                "type": "string",
                "description": "The new shipment status."
              },
              "labelURL": {
                "type": "string",
                "minLength": 1,
                "description": "Return label URL."
              },
              "shipmentId": {
                "type": "string",
                "minLength": 1,
                "description": "The shipment id."
              },
              "carrierName": {
                "type": "string",
                "minLength": 1,
                "description": "Carrier name."
              },
              "trackingURL": {
                "type": "string",
                "minLength": 1,
                "description": "Carrier tracking URL."
              },
              "trackingNumber": {
                "type": "string",
                "minLength": 1,
                "description": "Carrier tracking number."
              }
            }
          },
          "annotations": {
            "title": "Set shipment details",
            "readOnlyHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "returngo_add_rma_comment",
          "title": "Add an RMA comment",
          "description": "Add a merchant comment to an RMA's timeline. The note is HTML text. Adds a new comment each call. ReturnGO API: POST /rma/{rmaId}/comment.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "rmaId",
              "htmlText"
            ],
            "properties": {
              "rmaId": {
                "type": "string",
                "minLength": 1,
                "description": "The RMA id (from returngo_list_rmas)."
              },
              "htmlText": {
                "type": "string",
                "minLength": 1,
                "description": "The comment text, as HTML code (e.g. <p>Item checked.</p>)."
              }
            }
          },
          "annotations": {
            "title": "Add an RMA comment",
            "destructiveHint": true
          }
        },
        {
          "name": "returngo_set_rma_status",
          "title": "Set an RMA status",
          "description": "Move an RMA to a new status. ReturnGO runs every side effect of that transition, as set by the return policy (for example customer emails or refunds). Give reject_reason for Rejected and cancel_reason for Canceled. ReturnGO API: PUT /rma/{rmaId}/status.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "rmaId",
              "status"
            ],
            "properties": {
              "rmaId": {
                "type": "string",
                "minLength": 1,
                "description": "The RMA id (from returngo_list_rmas)."
              },
              "status": {
                "enum": [
                  "Pending",
                  "Approved",
                  "Received",
                  "Validated",
                  "Done",
                  "Rejected",
                  "Canceled"
                ],
                "type": "string",
                "description": "The new RMA status."
              },
              "cancel_reason": {
                "type": "string",
                "description": "Reason for cancelling the RMA (status Canceled)."
              },
              "reject_reason": {
                "type": "string",
                "description": "Reason for rejecting the RMA (status Rejected)."
              }
            }
          },
          "annotations": {
            "title": "Set an RMA status",
            "destructiveHint": true
          }
        },
        {
          "name": "returngo_update_transaction",
          "title": "Update a transaction",
          "description": "Set the status of a transaction, or link it to an external reference (for example a refund processed on your platform). Allowed transitions: Requested to Success or Failed, Failed to Success. ReturnGO API: PUT /transaction/{transactionId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "transactionId"
            ],
            "properties": {
              "status": {
                "enum": [
                  "Requested",
                  "Success",
                  "Failed",
                  "Canceled"
                ],
                "type": "string",
                "description": "The new transaction status."
              },
              "transactionId": {
                "type": "string",
                "minLength": 1,
                "description": "The transaction id (from returngo_list_transactions)."
              },
              "externalReferenceId": {
                "type": "string",
                "description": "Id of the matching record on your platform."
              },
              "externalReferenceType": {
                "enum": [
                  "PlatformRefundId",
                  "StoreCreditCode",
                  "GiftCardId",
                  "PaymentAuthorizationId",
                  "PaymentCaptureId",
                  "InvoicePaymentId",
                  "OrderId",
                  "Other"
                ],
                "type": "string",
                "description": "Type of the external reference."
              }
            }
          },
          "annotations": {
            "title": "Update a transaction",
            "readOnlyHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": [
        {
          "name": "getting_started",
          "description": "What you can do with ReturnGO here, with example requests to try."
        },
        {
          "name": "find_return_requests_waiting_for_action",
          "description": "Search return requests by status, dates or order names. Open one request to see its items, timeline and shipments."
        },
        {
          "name": "check_refunds_that_are_still_open",
          "description": "List refunds and payment transactions by status or type, such as the ones still in Requested status."
        },
        {
          "name": "set_an_rma_status_and_add_a_note",
          "description": "Move an RMA to a new status, such as Rejected with a reason. ReturnGO runs the side effects of that status, such as customer e-mails or refunds."
        },
        {
          "name": "update_a_refund_or_a_return_shipment",
          "description": "Update the status of a refund transaction, or link it to your own payment reference. Set the carrier and tracking number of a return shipment."
        },
        {
          "name": "review_the_webhooks_of_the_store",
          "description": "List the webhooks registered for the store, with their event subscriptions and target URLs."
        }
      ]
    },
    "instructions": "Tools for ReturnGO, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: \"Which return requests are waiting for approval?\"; \"Show me the RMAs created this week and their status.\"; \"Approve RMA 1234 and add a note that the item was checked.\". Read-only tools never change data; ask the user before a tool that creates, changes or deletes ReturnGO data. Free plan: 50 tool calls per month. Run returngo_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run returngo_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run returngo_upgrade without a plan: it returns both plans, each with a payment link for the user to open. returngo_cancel_subscription cancels Pro at the end of the paid period."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}