# Safefood 360 MCP by usefulapi

> Safefood 360 MCP by usefulapi is an MCP server. Read Safefood 360 documents, complaints, suppliers, materials; create complaints, update documents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/safefood-360/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/safefood-360
- **MCP Registry name:** io.usefulapi/safefood-360
- **Listing updated:** 2026-11-13

## About

Read Safefood 360 documents, complaints, suppliers, materials; create complaints, update documents.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http safefood-360 https://safefood-360.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://safefood-360.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "safefood-360": {
      "url": "https://safefood-360.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "safefood-360": {
      "type": "http",
      "url": "https://safefood-360.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "safefood-360": {
      "serverUrl": "https://safefood-360.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "safefood-360": {
      "type": "http",
      "url": "https://safefood-360.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `safefood360_list_documents`: List controlled documents of the Safefood 360 site (title, description, version, folder, responsible person, review/approval workflow, created/modified). Supports OData $filter, $orderby, $top, $skip and $count. GET /documents/sites/{siteId}/v1/documents/.
- `safefood360_get_document`: One controlled document by its identifier: title, description, version, folder, responsible person and workflow. GET /documents/sites/{siteId}/v1/documents/{identifier}.
- `safefood360_list_document_reviews`: List document reviews (the periodic review records of controlled documents). Supports OData $filter, $orderby, $top, $skip and $count; use it to find reviews that are due or overdue. GET /documents/sites/{siteId}/v1/documentreviews/.
- `safefood360_get_document_review`: One document review by its review number. GET /documents/sites/{siteId}/v1/documentreviews/{no}.
- `safefood360_list_complaints`: List customer complaints (number, name, risk, date, company, source, contact person, product/material, description, created/modified). Supports OData $filter, $orderby, $top, $skip and $count. GET /complaints/sites/{siteId}/v1/complaints.
- `safefood360_get_complaint`: One complaint by its id (GUID). GET /complaints/sites/{siteId}/v1/complaints/{id}.
- `safefood360_list_suppliers`: List suppliers (name, code, addresses, contacts, approval status, risk, establishment numbers). Paged with start_index and limit; the reply carries recordCount and next_start_index. GET /v1/suppliers/?siteId=.
- `safefood360_get_supplier`: One supplier by its external id. GET /v1/suppliers/{externalId}?siteId=.
- `safefood360_list_materials`: List materials/ingredients (name, our code, supplier code, description, category, countries of origin, risk, archived flag). Paged with start_index and limit; the reply carries recordCount and next_start_index. GET /v1/materials/?siteId=.
- `safefood360_get_material`: One material by its external id. GET /v1/materials/{externalId}?siteId=.
- `safefood360_get_customer`: One customer by its identifier (name, addresses, phone, notes). The vendor offers no customer list. GET /customers/sites/{siteId}/v1/customers/{identifier}.
- `safefood360_get_employee`: One employee record by its identifier (training/HR master data of the site). Contains personal data: use it only for the question asked. The vendor offers no employee list. GET /employees/sites/{siteId}/v1/employees/{identifier}.
- `safefood360_get_final_product`: One final (finished) product by its identifier: name, folder, categories, barcode, specifications and the materials it is made of. The vendor offers no final-product list. GET /finalproducts/sites/{siteId}/v1/finalproducts/{identifier}.
- `safefood360_get_batching_record`: One batching (traceability) record by its id (GUID). GET /batching/sites/{siteId}/v1/batching/records/{recordId}.
- `safefood360_update_document`: WRITE: change the title, description and/or folder of a controlled document in Safefood 360 (JSON patch; fields you leave out stay as they are). It does not publish a new version or change the review workflow. Returns the updated document. PATCH /documents/sites/{siteId}/v1/documents/{identifier}.
- `safefood360_update_customer`: WRITE: change the name, phone, mobile and/or notes of a customer in Safefood 360 (JSON patch of those fields; others stay as they are). notes REPLACES the existing notes. PATCH /customers/sites/{siteId}/v1/customers/{identifier}.
- `safefood360_create_complaint`: WRITE: record a NEW complaint in Safefood 360 (it may trigger the site's complaint workflow and notifications). Not idempotent: calling it twice creates two complaints. Safefood 360 validates the fields (ids such as source, company and recorded_by are GUIDs from your site's lists) and rejects a request that lacks required ones. POST /complaints/sites/{siteId}/v1/complaints/.

## FAQ

### How do I add Safefood 360 MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http safefood-360 https://safefood-360.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/safefood-360-mcp-by-usefulapi
