tadaaa MCP Server

MCP server exposing the Tadaaa reviews API via the Model Context Protocol over stdio transport.

Setup

cd mcp
npm install
npm run build

Environment variables

| Variable | Required | Default | Description | |---|---|---|---| | TADAAA_BASE_URL | No | http://localhost:3000 | Base URL for the API. Use https://tadaaa.uk.com for production. | | TADAAA_AUTH_TOKEN | Yes | — | Bearer token for API authentication. |

Tools

Reviews

| Tool | Description | |---|---| | list_reviews | List reviews with optional sort (date_asc / date_desc), limit, and offset. | | get_review | Get a single review by id. | | create_review | Create a review. Pass external_id for idempotency. | | update_review | Update a review by id. | | upload_review_photo | Upload a photo to a review (ContentPhoto). Params: review_id, file_path, optional placement (card/page), orientation (horizontal/vertical). | | upload_review_video | Upload a video to a review (ContentVideo). Params: review_id, file_path, optional placement, orientation. | | delete_review_photo | Delete a content photo by ID. | | delete_review_video | Delete a content video by ID. |

Products

| Tool | Description | |---|---| | list_products | List products. Params: q (search), exact (true=substring, false=fuzzy), limit, offset. | | get_product | Get a product by id or slug. | | create_product | Create a product. Requires name, and sub_category_id or sub_category_slug. Optional: short_name, archived, bestseller, about, price, cost, supplier_id, supplier_link, composition, allergens. | | update_product | Update a product by id or slug. Same optional fields as create. |

Suppliers

| Tool | Description | |---|---| | list_suppliers | List suppliers (id and name only). Read-only. |

Subcategories

| Tool | Description | |---|---| | list_sub_categories | List child subcategories with id, name, path (Category > Parent > Child), and active. |

Cursor / Claude Desktop configuration

Add to your MCP config (e.g. ~/.cursor/mcp.json):

{
  "mcpServers": {
    "tadaaa": {
      "command": "node",
      "args": ["/path/to/tadaaa-backend/mcp/dist/index.js"],
      "env": {
        "TADAAA_BASE_URL": "http://localhost:3000",
        "TADAAA_AUTH_TOKEN": "your-token-here"
      }
    }
  }
}

Development (no build step)

npm run dev

Release

From the project root:

bundle exec rake mcp:release

Bumps minor version, builds with tsc, and publishes to npm.