{
  "name": "graj",
  "title": "GRAJ Protocol",
  "version": "2026.09",
  "description": "The GRAJ Protocol MCP server. Add it to Claude, ChatGPT or any MCP client and sign in with your GRAJ account, or use your own API key. Every tool answers about the signed-in account or about public catalog, directory and help data. Every tool but one reads; that one saves a draft order the person places themselves. Nothing places an order, messages anybody or moves money. Your own AI plan pays for the thinking; GRAJ calls no model.",
  "endpoint": "https://www.getreadyandjump.com/api/v1/mcp",
  "transport": {
    "type": "streamable-http",
    "responses": "application/json",
    "streaming": false
  },
  "protocolVersions": [
    "2025-06-18",
    "2025-03-26",
    "2024-11-05"
  ],
  "methods": [
    "initialize",
    "ping",
    "tools/list",
    "tools/call"
  ],
  "authentication": {
    "required": true,
    "schemes": [
      {
        "type": "oauth2",
        "flow": "authorization_code",
        "pkce": "S256",
        "dynamicClientRegistration": true,
        "protectedResourceMetadata": "https://www.getreadyandjump.com/.well-known/oauth-protected-resource",
        "authorizationServerMetadata": "https://www.getreadyandjump.com/.well-known/oauth-authorization-server",
        "scopes": [
          "read",
          "drafts"
        ]
      },
      {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      },
      {
        "type": "http",
        "scheme": "bearer",
        "format": "graj_live_…"
      }
    ],
    "keysFrom": "https://www.getreadyandjump.com/settings/api-keys",
    "note": "Sign in with your own GRAJ account, or use your own key. GRAJ issues no keys to third parties."
  },
  "rateLimit": "600 requests a minute per key or per signed-in app",
  "readOnly": false,
  "writes": "drafts only",
  "tools": [
    {
      "name": "list_my_products",
      "description": "Your own catalog: name, SKU, status, wholesale and retail price in cents, stock, minimum order quantity and case pack.",
      "readOnly": true
    },
    {
      "name": "list_my_orders",
      "description": "Orders you are the seller or a brand on, newest first, with your own share in cents; open_only for the ones still moving.",
      "readOnly": true
    },
    {
      "name": "list_my_leads",
      "description": "Your own pipeline, as your Leads screen lists it: store, contact, stage, zone, tier and next action.",
      "readOnly": true
    },
    {
      "name": "list_my_customers",
      "description": "Your own customer book, as your Customers screen lists it: orders, spend and the last order.",
      "readOnly": true
    },
    {
      "name": "my_day_plan",
      "description": "Your plan for a day: each stop in order, its status and the lead's next action, with map links.",
      "readOnly": true
    },
    {
      "name": "order_stops",
      "description": "Put stops or your own leads into a driving order (nearest-next, then 2-opt), with map links. Saves nothing.",
      "readOnly": true
    },
    {
      "name": "my_receivables",
      "description": "What your buyers owe you, aged from each due date, with the biggest buyers and their risk.",
      "readOnly": true
    },
    {
      "name": "search_directory",
      "description": "The public participant directory Explore searches, from a plain-English role and place.",
      "readOnly": true
    },
    {
      "name": "search_catalog",
      "description": "Active products on GRAJ whose name matches a query. No prices.",
      "readOnly": true
    },
    {
      "name": "search_help_centre",
      "description": "GRAJ's published help articles, FAQ, glossary and guides, ranked for a query.",
      "readOnly": true
    },
    {
      "name": "protocol_facts",
      "description": "The protocol fee, what the MCP server can and cannot do, and how to revoke it.",
      "readOnly": true
    },
    {
      "name": "draft_order_for_customer",
      "description": "Save a draft order for one of your customers, marked drafted by your assistant. Not placed: nothing is sent and nobody is charged until you place it yourself in GRAJ.",
      "readOnly": false
    }
  ],
  "links": {
    "agentCard": "https://www.getreadyandjump.com/.well-known/agent-card.json",
    "openapi": "https://www.getreadyandjump.com/openapi.json",
    "llms": "https://www.getreadyandjump.com/llms.txt",
    "docs": "https://www.getreadyandjump.com/docs"
  }
}