Crear o fusionar entidad
osint_upsert_entitySave or update an entity in an OSINT investigation case, normalizing its value and merging sources to return a deterministic entity_id for graph use.
Instructions
Guarda una entidad en un caso (lo crea si no existe). Normaliza el valor y devuelve su entity_id determinista. Reinsertar fusiona fuentes y propiedades. Úsala también para volcar al grafo datos de otros MCP (MISP, ATT&CK, TheHive...) con source=.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"case_id": "<case_id>",
"entity_type": "<entity_type>",
"value": "<value>"
},
"name": "osint_upsert_entity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Notas del analista. | |
| value | Yes | Valor de la entidad (ej.: example.com). | |
| source | No | Origen del dato (manual, misp, attack...). | manual |
| case_id | Yes | Id del caso: 2-63 caracteres a-z, 0-9, '-' o '_' (ej.: caso-2026-001). | |
| confidence | No | Confianza 0-1 en el dato. | |
| properties | No | Propiedades adicionales "clave=valor". | |
| entity_type | Yes | Tipo Maltego (ver osint_list_entity_types), p. ej. maltego.Domain, propio (acme.Ticket) o "auto" para detectarlo por el valor (correo, URL, IP, rango, hash, AS, teléfono, dominio o frase). | |
| response_format | No | "markdown" (por defecto, legible) o "json" (estructurado). | markdown |