Giatec ecosystem
SmartMix MixPilot SmartRock
Model Context Protocol Server

Giatec Platform
MCP Server

Connect any AI agent to SmartMix and MixPilot — query mix designs, track deliveries, and monitor IoT-equipped trucks through natural language.

40+
MCP Tools
2
APIs Integrated
4
AI Clients Supported
MCP
Protocol 2025-11-25
ℹ️

What is this?

This is the Giatec Platform MCP Server — a Model Context Protocol server that wraps Giatec's SmartMix (concrete mix design) and MixPilot (IoT delivery tracking) REST APIs as structured tools for AI agents.

AI agents — Claude, ChatGPT, Gemini, Copilot, and others — connect here and can authenticate, query mix designs, inspect delivery tickets, and monitor in-transit trucks with live sensor data, all through natural language.

This is not a web application. There is no browser-based UI — authentication and all interactions happen through MCP tools called by an AI agent.

🔌

Endpoints

POST /mcp MCP Streamable HTTP — connect AI agents here
GET /health Returns server status and environment
🔗

How to connect

⌨️
Claude Code
CLI — one command
Terminal
claude mcp add giatec \
  --transport http \
  __SERVER_URL__/mcp

Or add to .claude/settings.json:

{
  "mcpServers": {
    "giatec": {
      "type": "http",
      "url":  "__SERVER_URL__/mcp"
    }
  }
}
🖥️
Claude Desktop
macOS / Windows app

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "giatec": {
      "type": "streamable-http",
      "url":  "__SERVER_URL__/mcp"
    }
  }
}
Cursor / VS Code
MCP settings
{
  "giatec": {
    "url": "__SERVER_URL__/mcp"
  }
}
🛠️
Verify with curl
Quick health check
Terminal
curl -s __SERVER_URL__/health

# Expected response:
{
  "status":  "ok",
  "service": "Giatec Platform MCP Server",
  "env":     "development"
}
🚀

First steps after connecting

1
Authenticate with your Giatec credentials
auth_login(username="you@company.com", password="...")
2
Select account (super_user only — skip if admin or member)
auth_select_account(account_id="acct_abc123")
3
Start exploring
# Browse mix designs
smartmix_list_mixes()

# Monitor in-transit trucks
mixpilot_list_trips(
  start_time="2024-06-01T00:00:00Z",
  end_time="2024-06-02T00:00:00Z"
)
🧰

Available tools

AuthAuthentication
auth_loginauth_select_accountauth_whoamiauth_logout
SMMix Designs
smartmix_list_mixessmartmix_get_mixsmartmix_query_mixessmartmix_create_mixsmartmix_get_mix_overviewsmartmix_get_mix_analytics_designedsmartmix_get_mix_analytics_delivered
SMMaterials
smartmix_list_materialssmartmix_query_materialssmartmix_create_materialsmartmix_copy_material
SMPlants & Trucks
smartmix_query_plantssmartmix_create_plantsmartmix_query_truckssmartmix_get_trucksmartmix_create_truck
SMCustomers & Suppliers
smartmix_list_customerssmartmix_get_customersmartmix_list_supplierssmartmix_get_suppliersmartmix_create_supplier
SMTickets & Projects
smartmix_list_ticketssmartmix_query_ticketssmartmix_list_projectssmartmix_get_projectsmartmix_create_project
MPMixPilot Tickets
mixpilot_list_ticketsmixpilot_get_ticketmixpilot_get_ticket_intransitmixpilot_list_intransit_ticketsmixpilot_get_slump_by_ticketmixpilot_get_ticket_timeseries
MPTrips
mixpilot_list_tripsmixpilot_get_tripmixpilot_get_trip_timeseries
MPDevices & Trucks
mixpilot_list_devicesmixpilot_get_devicemixpilot_list_gatewaysmixpilot_list_trucksmixpilot_get_truckmixpilot_create_truckmixpilot_update_truck