{
  "info": {
    "name": "Magnetic — mcp.ai",
    "description": "REST API for the Magnetic 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/magnetic",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "magnetic_clients_get_current_followups",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/clients/get/current/followups",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "clients",
            "get",
            "current",
            "followups"
          ]
        },
        "description": "Tool to retrieve upcoming follow-ups assigned to the authenticated user. Use after authentication to view scheduled tasks.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_clients_search_contacts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/clients/search/contacts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "clients",
            "search",
            "contacts"
          ]
        },
        "description": "Tool to search contacts by field or client ID. Use when you need to retrieve client contacts matching given criteria after authentication.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"field\": \"\",\n  \"limit\": 0,\n  \"value\": \"\",\n  \"offset\": 0,\n  \"clientId\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_create_grouping",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/grouping",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "grouping"
          ]
        },
        "description": "Tool to create a new opportunity or job (grouping) in Magnetic HQ. Use when you need to organize tasks and track project progress for a new opportunity or job.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"extra\": \"\",\n  \"owner\": {},\n  \"contact\": {},\n  \"contactCompany\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_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 in Magnetic HQ. Use when you need to add tasks to the system, optionally assigning them to users or linking to opportunities.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"task\": \"\",\n  \"user\": {},\n  \"endDate\": \"\",\n  \"billable\": false,\n  \"grouping\": {},\n  \"startDate\": \"\",\n  \"description\": \"\",\n  \"timeMinutes\": 0,\n  \"effortMinutes\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_get_contact_tags",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/contact/tags",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "contact",
            "tags"
          ]
        },
        "description": "Tool to get all tags associated with a contact. Use after confirming the contactId to list contact tags.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"contactId\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_get_grouping_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/grouping/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "grouping",
            "by",
            "id"
          ]
        },
        "description": "Tool to retrieve details for a specific grouping (opportunity/job) by its ID. Use when you need detailed information about a specific grouping.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_get_grouping_statuses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/grouping/statuses",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "grouping",
            "statuses"
          ]
        },
        "description": "Tool to retrieve the list of statuses for signed groupings. Use after authentication when you need available grouping status options for tasks or jobs.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_get_grouping_tags",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/grouping/tags",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "grouping",
            "tags"
          ]
        },
        "description": "Tool to retrieve tags associated with any groupings owned by the company. Use after authentication when grouping tags are needed.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_get_opportunity_statuses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/opportunity/statuses",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "opportunity",
            "statuses"
          ]
        },
        "description": "Tool to retrieve opportunity statuses. Use when you need current status options for unsigned groupings (opportunities).",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_get_task",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/task",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "task"
          ]
        },
        "description": "Tool to retrieve a task by its ID. Use after confirming you have the taskId.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"taskId\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_get_user_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/user/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "user",
            "by",
            "id"
          ]
        },
        "description": "Tool to retrieve details for a specific Magnetic user by their ID. Use when you need to fetch a user's profile information.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_get_users",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "users"
          ]
        },
        "description": "Tool to retrieve the list of all users in the authenticated user's company. Use after authentication to audit or manage user accounts.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_list_companies",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/companies",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "companies"
          ]
        },
        "description": "Tool to retrieve all companies from the Magnetic HQ account. Use after authentication to view all client companies.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "magnetic_tasks_get_grouping_custom_field_definitions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/tasks/get/grouping/custom/field/definitions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "tasks",
            "get",
            "grouping",
            "custom",
            "field",
            "definitions"
          ]
        },
        "description": "Tool to retrieve all custom field definitions for groupings. Use after authentication when you need to fetch available grouping custom field definitions for tasks.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}