{
  "info": {
    "name": "JobNimbus — mcp.ai",
    "description": "REST API for the JobNimbus MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/jobnimbus",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "jobnimbus_account_create_location",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/account/create/location",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "account",
            "create",
            "location"
          ]
        },
        "description": "Tool to create a new location in JobNimbus. Use after gathering address and contact details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"zip\": \"\",\n  \"city\": \"\",\n  \"code\": \"\",\n  \"name\": \"\",\n  \"phone\": \"\",\n  \"is_active\": false,\n  \"state_text\": \"\",\n  \"country_name\": \"\",\n  \"address_line1\": \"\",\n  \"address_line2\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_account_get_settings",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/account/get/settings",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "account",
            "get",
            "settings"
          ]
        },
        "description": "Tool to retrieve account-wide settings (workflows, types, sources). Use after authenticating to load or refresh workflow and source mappings.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"actor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_activity_get",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/activity/get",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "activity",
            "get"
          ]
        },
        "description": "Retrieves a specific JobNimbus activity by its unique jnid. Activities in JobNimbus represent logged events such as task modifications, contact updates, job creation, and other system actions. Each ac",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"jnid\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_contact_get",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/contact/get",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "contact",
            "get"
          ]
        },
        "description": "Tool to retrieve a contact by ID. Use after obtaining the contact’s jnid to fetch full details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"jnid\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_contact_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/contact/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "contact",
            "list"
          ]
        },
        "description": "Tool to list all contacts. Use when you need to fetch multiple contacts, e.g., for reporting or synchronization.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"from\": 0,\n  \"size\": 0,\n  \"fields\": \"\",\n  \"filter\": \"\",\n  \"sort_field\": \"\",\n  \"sort_direction\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_contact_update",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/contact/update",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "contact",
            "update"
          ]
        },
        "description": "Tool to update an existing contact. Use when you have a contact's JNID and need to modify its fields. Call after fetching or creating a contact.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"zip\": \"\",\n  \"city\": \"\",\n  \"jnid\": \"\",\n  \"tags\": \"\",\n  \"email\": \"\",\n  \"company\": \"\",\n  \"website\": \"\",\n  \"lastName\": \"\",\n  \"faxNumber\": \"\",\n  \"firstName\": \"\",\n  \"homePhone\": \"\",\n  \"stateText\": \"\",\n  \"workPhone\": \"\",\n  \"externalId\": \"\",\n  \"sourceName\": \"\",\n  \"statusName\": \"\",\n  \"contactType\": \"\",\n  \"description\": \"\",\n  \"displayName\": \"\",\n  \"mobilePhone\": \"\",\n  \"addressLine1\": \"\",\n  \"addressLine2\": \"\",\n  \"salesRepName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_create_file_type",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/file/type",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "file",
            "type"
          ]
        },
        "description": "Creates a new file attachment type in JobNimbus. File types are custom categories used to organize and classify document attachments (e.g., contracts, warranties, photos, permits). You must create a f",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"IsActive\": false,\n  \"TypeName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_create_material_order",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/material/order",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "material",
            "order"
          ]
        },
        "description": "Creates a new material order in JobNimbus. A material order tracks materials needed for a job and can be submitted to suppliers. Material orders must be linked to a contact or job record and include a",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"items\": \"\",\n  \"notes\": \"\",\n  \"number\": \"\",\n  \"status\": 0,\n  \"related\": \"\",\n  \"vendorId\": 0,\n  \"assignedToId\": 0,\n  \"expectedDate\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_create_task",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/task",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "task"
          ]
        },
        "description": "Tool to create a new task. Use when scheduling or tracking tasks linked to contacts or jobs.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"title\": \"\",\n  \"related\": \"\",\n  \"date_end\": 0,\n  \"date_start\": 0,\n  \"record_type\": 0,\n  \"record_type_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_create_workflow_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/workflow/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "workflow",
            "status"
          ]
        },
        "description": "Tool to create a new status in an existing workflow. Use after confirming the workflow ID to add specialized status entries like 'Lead' or 'Inspection'.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"is_lead\": false,\n  \"is_active\": false,\n  \"is_closed\": false,\n  \"workflowid\": \"\",\n  \"is_archived\": false,\n  \"force_mobile_sync\": false,\n  \"send_to_quickbooks\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_file_get",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/file/get",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "file",
            "get"
          ]
        },
        "description": "Retrieves the raw content of a specific file attachment from JobNimbus by its unique ID. This action downloads the actual file content (binary data for PDFs, images, etc.) but does NOT return file met",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"jnid\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_list_activities",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/activities",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "activities"
          ]
        },
        "description": "Tool to retrieve all activities. Use after authentication to fetch a paginated list of activities.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"size\": 0,\n  \"filter\": \"\",\n  \"offset\": 0,\n  \"sort_field\": \"\",\n  \"sort_direction\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_list_invoices",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/invoices",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "invoices"
          ]
        },
        "description": "Tool to list all invoices (v2). Use when you need to fetch multiple invoice records.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"from\": 0,\n  \"size\": 0,\n  \"fields\": \"\",\n  \"filter\": \"\",\n  \"sort_field\": \"\",\n  \"sort_direction\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_list_material_orders",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/material/orders",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "material",
            "orders"
          ]
        },
        "description": "Tool to list all material orders (v2). Use after authentication to fetch multiple material order records.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"from\": 0,\n  \"size\": 0,\n  \"fields\": \"\",\n  \"filter\": \"\",\n  \"sort_field\": \"\",\n  \"sort_direction\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_list_payments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/payments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "payments"
          ]
        },
        "description": "Tool to retrieve payments list with optional filters. Use after auth.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"jobId\": 0,\n  \"dateTo\": \"\",\n  \"perPage\": 0,\n  \"dateFrom\": \"\",\n  \"contactId\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_list_products",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/products",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "products"
          ]
        },
        "description": "Tool to list all products. Use after authentication to fetch full product catalog.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"from\": 0,\n  \"size\": 0,\n  \"fields\": \"\",\n  \"filter\": \"\",\n  \"sort_field\": \"\",\n  \"sort_direction\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_list_workorders",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/workorders",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "workorders"
          ]
        },
        "description": "Tool to retrieve all work orders (v2). Use after authentication when you need a paginated list of work orders.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"from\": 0,\n  \"size\": 0,\n  \"fields\": \"\",\n  \"filter\": \"\",\n  \"sort_field\": \"\",\n  \"sort_direction\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_product_get",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/product/get",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "product",
            "get"
          ]
        },
        "description": "Retrieves detailed information about a specific JobNimbus product using its jnid. Use this action when you need to get full details about a product, including pricing, cost, unit of measurement, and t",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"jnid\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_task_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/task/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "task",
            "list"
          ]
        },
        "description": "Tool to list all tasks. Use when you need an overview of tasks for planning or review.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"status\": \"\",\n  \"due_date\": \"\",\n  \"per_page\": 0,\n  \"assigned_to\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_update_task",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/task",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "task"
          ]
        },
        "description": "Update an existing JobNimbus task by its jnid. Allows updating task details like title, description, dates, priority, and task type. Use List Tasks action to find task jnids. Note: To update task type",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"jnid\": \"\",\n  \"title\": \"\",\n  \"date_end\": 0,\n  \"priority\": 0,\n  \"date_start\": 0,\n  \"description\": \"\",\n  \"record_type\": 0,\n  \"record_type_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "jobnimbus_utility_get_uoms",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/utility/get/uoms",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "utility",
            "get",
            "uoms"
          ]
        },
        "description": "Tool to retrieve list of supported units of measure. Use after authenticating when you need to present or validate measurement units.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}