{
  "openapi": "3.1.0",
  "info": {
    "title": "Meteoro Minerals Agent API",
    "version": "1.0.0",
    "summary": "Solo lectura / Read only",
    "description": "API pública de solo lectura de Meteoro Minerals para agentes de IA: catálogo, normas, cobertura, precios de referencia publicados (noviembre de 2026), legalidad y contacto por WhatsApp. No toma pedidos ni calcula precios; el prediseño de mezcla registra un folio sin datos personales. Límite: 60 llamadas por minuto por IP. / Public read-only API for AI agents. No orders, no price math.",
    "contact": {
      "name": "Meteoro Minerals",
      "email": "info@meteoroai.com",
      "url": "https://www.meteoro.io/agentes"
    },
    "license": {
      "name": "Datos públicos de Meteoro Minerals",
      "url": "https://www.meteoro.io"
    }
  },
  "servers": [
    {
      "url": "https://fsuayuqxuncsamfyayrt.supabase.co/functions/v1/meteoro-agent-api"
    }
  ],
  "externalDocs": {
    "url": "https://www.meteoro.io/en/agents",
    "description": "AI2AI docs"
  },
  "paths": {
    "/buscar_catalogo": {
      "get": {
        "operationId": "buscar_catalogo",
        "summary": "Materiales del catálogo oficial con su norma, enlace a la familia y precio de referencia publicado.",
        "description": "Official catalog materials with their standard, family link and published reference price.",
        "tags": [
          "meteoro"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "B-400"
              ]
            },
            "description": "Material, uso o norma / Material, use or standard"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "es",
                "en"
              ],
              "default": "es"
            },
            "description": "Idioma / Language"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tool": {
                      "type": "string",
                      "const": "buscar_catalogo"
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "404": {
            "description": "Herramienta desconocida / Unknown tool"
          },
          "429": {
            "description": "Más de 60 llamadas por minuto / Rate limited",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    },
    "/ficha_tecnica": {
      "get": {
        "operationId": "ficha_tecnica",
        "summary": "Ficha técnica publicada de un material: código, norma, usos declarados, unidad, precio de referencia si está publicado, zonas, logística, legalidad, URL de la ficha y su JSON; valores de ensayo solo donde el dueño publicó la Caracterización de septiembre de 2026.",
        "description": "Published technical data sheet for a material: code, standard, stated uses, unit, reference price when published, areas, logistics, legality, sheet URL and its JSON; test values only where the owner published the September 2026 characterization.",
        "tags": [
          "meteoro"
        ],
        "parameters": [
          {
            "name": "material",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "B-400 IDU"
              ]
            },
            "description": "Material / Material"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "es",
                "en"
              ],
              "default": "es"
            },
            "description": "Idioma / Language"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tool": {
                      "type": "string",
                      "const": "ficha_tecnica"
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "404": {
            "description": "Herramienta desconocida / Unknown tool"
          },
          "429": {
            "description": "Más de 60 llamadas por minuto / Rate limited",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    },
    "/consultar_norma": {
      "get": {
        "operationId": "consultar_norma",
        "summary": "Norma del mapa verificado (IDU ET 1999, IDU 2011 y 2018, INVIAS 2013, 2020 y 2022, NP 040 EAAB) para un material o uso.",
        "description": "Verified-map standard (IDU, INVIAS, EAAB) for a material or use.",
        "tags": [
          "meteoro"
        ],
        "parameters": [
          {
            "name": "material",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "subbase"
              ]
            },
            "description": "Material / Material"
          },
          {
            "name": "uso",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "vía nacional INVIAS"
              ]
            },
            "description": "Uso o capa / Use or layer"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "es",
                "en"
              ],
              "default": "es"
            },
            "description": "Idioma / Language"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tool": {
                      "type": "string",
                      "const": "consultar_norma"
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "404": {
            "description": "Herramienta desconocida / Unknown tool"
          },
          "429": {
            "description": "Más de 60 llamadas por minuto / Rate limited",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    },
    "/verificar_cobertura": {
      "get": {
        "operationId": "verificar_cobertura",
        "summary": "Si un municipio o departamento está en las cinco zonas de operación.",
        "description": "Whether a municipality or department is inside the five operating areas.",
        "tags": [
          "meteoro"
        ],
        "parameters": [
          {
            "name": "lugar",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "Funza"
              ]
            },
            "description": "Municipio o departamento / Municipality or department"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "es",
                "en"
              ],
              "default": "es"
            },
            "description": "Idioma / Language"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tool": {
                      "type": "string",
                      "const": "verificar_cobertura"
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "404": {
            "description": "Herramienta desconocida / Unknown tool"
          },
          "429": {
            "description": "Más de 60 llamadas por minuto / Rate limited",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    },
    "/precios_referencia": {
      "get": {
        "operationId": "precios_referencia",
        "summary": "Precios de referencia publicados en origen, antes de IVA, con mes y vigencia. El precio real se da por WhatsApp.",
        "description": "Published reference prices at origin, before VAT, with month and validity. The actual price is given on WhatsApp.",
        "tags": [
          "meteoro"
        ],
        "parameters": [
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "es",
                "en"
              ],
              "default": "es"
            },
            "description": "Idioma / Language"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tool": {
                      "type": "string",
                      "const": "precios_referencia"
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "404": {
            "description": "Herramienta desconocida / Unknown tool"
          },
          "429": {
            "description": "Más de 60 llamadas por minuto / Rate limited",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    },
    "/legalidad": {
      "get": {
        "operationId": "legalidad",
        "summary": "RUCOM, certificaciones ISO con vigencia, trazabilidad de extremo a extremo (ANM y RNDC) y enlace a la consulta pública de la ANM.",
        "description": "RUCOM, ISO certifications with validity, traceability and the public ANM lookup link.",
        "tags": [
          "meteoro"
        ],
        "parameters": [
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "es",
                "en"
              ],
              "default": "es"
            },
            "description": "Idioma / Language"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tool": {
                      "type": "string",
                      "const": "legalidad"
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "404": {
            "description": "Herramienta desconocida / Unknown tool"
          },
          "429": {
            "description": "Más de 60 llamadas por minuto / Rate limited",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    },
    "/prediseno_mezcla": {
      "get": {
        "operationId": "prediseno_mezcla",
        "summary": "Prediseño de referencia de concreto sin aire incluido por ACI 211.1 con la caracterización de septiembre de 2026 de los agregados Meteoro Guayuriba: cantidades por m³, a/c, f'cr, valores de tabla y de ficha usados, folio y hash SHA-256 verificables. Sin precios. Registra un folio sin datos personales.",
        "description": "Reference non-air-entrained concrete pre-design (ACI 211.1) with the September 2026 characterization of the Meteoro Guayuriba aggregates: quantities per m³, w/c, f'cr, table and data sheet values used, verifiable folio and SHA-256 hash. No prices. Stores one folio with no personal data.",
        "tags": [
          "meteoro"
        ],
        "parameters": [
          {
            "name": "fc",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "21"
              ]
            },
            "description": "f'c en MPa o psi / f'c in MPa or psi"
          },
          {
            "name": "fc_unidad",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "MPa"
              ]
            },
            "description": "MPa o psi / MPa or psi"
          },
          {
            "name": "asentamiento",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "75-100"
              ]
            },
            "description": "25-50, 75-100 o 150-175 (mm) / 25-50, 75-100 or 150-175 (mm)"
          },
          {
            "name": "grava",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "1\""
              ]
            },
            "description": "1\" o 1/2\" / 1\" or 1/2\""
          },
          {
            "name": "densidad_cemento",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "description": "g/cm³, por defecto 3,10 (valor asumido) / g/cm³, default 3.10 (assumed)"
          },
          {
            "name": "humedad_grava",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "description": "Humedad de la grava, % / Gravel moisture, %"
          },
          {
            "name": "humedad_arena",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "description": "Humedad de la arena, % / Sand moisture, %"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "es",
                "en"
              ],
              "default": "es"
            },
            "description": "Idioma / Language"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tool": {
                      "type": "string",
                      "const": "prediseno_mezcla"
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "404": {
            "description": "Herramienta desconocida / Unknown tool"
          },
          "429": {
            "description": "Más de 60 llamadas por minuto / Rate limited",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    },
    "/verificar_prediseno": {
      "get": {
        "operationId": "verificar_prediseno",
        "summary": "Recalcula un prediseño guardado por su folio y dice si el hash coincide.",
        "description": "Recomputes a stored pre-design by folio and says whether the hash matches.",
        "tags": [
          "meteoro"
        ],
        "parameters": [
          {
            "name": "folio",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "PM-1243A3E7C2"
              ]
            },
            "description": "Folio PM-… / Folio PM-…"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "es",
                "en"
              ],
              "default": "es"
            },
            "description": "Idioma / Language"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tool": {
                      "type": "string",
                      "const": "verificar_prediseno"
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "404": {
            "description": "Herramienta desconocida / Unknown tool"
          },
          "429": {
            "description": "Más de 60 llamadas por minuto / Rate limited",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    },
    "/contacto": {
      "get": {
        "operationId": "contacto",
        "summary": "Enlace de WhatsApp con un mensaje listo para que su humano lo envíe. No envía nada ni toma pedidos.",
        "description": "Pre-filled WhatsApp link for your human to send. Sends nothing, takes no orders.",
        "tags": [
          "meteoro"
        ],
        "parameters": [
          {
            "name": "material",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "B-400"
              ]
            },
            "description": "Material / Material"
          },
          {
            "name": "cantidad",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "600 m³"
              ]
            },
            "description": "Cantidad con unidad / Quantity with unit"
          },
          {
            "name": "obra",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "Funza"
              ]
            },
            "description": "Municipio de la obra / Site municipality"
          },
          {
            "name": "agente",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "examples": [
                "ChatGPT"
              ]
            },
            "description": "Nombre de su agente / Your agent's name"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "es",
                "en"
              ],
              "default": "es"
            },
            "description": "Idioma / Language"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tool": {
                      "type": "string",
                      "const": "contacto"
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "404": {
            "description": "Herramienta desconocida / Unknown tool"
          },
          "429": {
            "description": "Más de 60 llamadas por minuto / Rate limited",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    }
  }
}
