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
sm_list_mixes()

# Monitor in-transit trucks
mp_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
sm_list_mixessm_get_mixsm_query_mixessm_create_mixsm_get_mix_overviewsm_get_mix_analytics_designedsm_get_mix_analytics_delivered
SMMaterials
sm_list_materialssm_query_materialssm_create_materialsm_copy_material
SMPlants & Trucks
sm_query_plantssm_create_plantsm_query_truckssm_get_trucksm_create_truck
SMCustomers & Suppliers
sm_list_customerssm_get_customersm_list_supplierssm_get_suppliersm_create_supplier
SMTickets & Projects
sm_list_ticketssm_query_ticketssm_list_projectssm_get_projectsm_create_project
MPMixPilot Tickets
mp_list_ticketsmp_get_ticketmp_get_ticket_intransitmp_list_intransit_ticketsmp_get_slump_by_ticketmp_get_timeseries_by_ticket
MPTrips
mp_list_tripsmp_get_tripmp_get_trip_timeseries
MPDevices & Trucks
mp_list_devicesmp_get_devicemp_list_gatewaysmp_list_trucksmp_get_truckmp_create_truckmp_update_truck