Technical documentation and sequential steps to integrate the Shartify Trust Rank calculations and zero-knowledge business audits.
INXA AI+ Agent never acquires or stores financial statements, patents, or sensitive corporate data. The enterprise only registers public, non-proprietary metadata. For protected data, they nominate one or more Guarantors (Certified Professionals), who keep physical files in custody and answer targeted audit questions generated by the LLM.
The enterprise declares public metadata and associates the emails of nominated certified guarantors. The LLM parses the public disclosures and automatically generates exactly 2 targeted audit questions per guarantor.
{
"alias": "azienda-innovativa",
"title": "Azienda Innovativa S.r.l.",
"type": "company",
"description": "Advanced software development for logistics.",
"url": "https://azienda-innovativa.it",
"guarantors": [
{
"name": "Dr. Mario Rossi",
"email": "[email protected]",
"role": "Accountant"
}
]
}
Success Response:
{
"success": true,
"node_id": "azienda-innovativa",
"message": "Node pre-registered successfully. 2 audit questions generated for guarantors."
}
The nominated Guarantor logs into the portal and submits answers to the compliance questions generated by the LLM (either binary Yes/No or 0-10 metric scale). These responses act as verification without uploading sensitive files to the server.
{
"question_id": 12,
"guarantor_email": "[email protected]",
"response_value": "9",
"comment": "I verify the compliance of the financial statements deposited on 10/05/2026."
}
Success Response:
{
"success": true,
"message": "Guarantor response submitted successfully."
}
Gated by admin credentials. Allows the administrator to inject custom audit criteria or questions for the node's guarantors before compiling the final trust rank.
Authorization: Bearer ADMIN_TOKEN (nominal coordinates)Request Payload (JSON):
{
"node_alias": "azienda-innovativa",
"guarantor_email": "[email protected]",
"question_text": "Does the company possess adequate insurance coverage for cyber risks?",
"type": "binary"
}
Success Response:
{
"success": true,
"question_id": 15,
"message": "Custom question added for guarantor."
}
The administrator triggers the evaluation. The LLM performs web research (via Tavily), cross-references certified guarantor responses and public declarations, and generates an official Trust Rank (0-10) with detailed rationale.
{
"node_alias": "azienda-innovativa"
}
Success Response:
{
"success": true,
"trust_rank": 8.7,
"rationale": "The company has solid accountant-backed statements and approved patents. Web search reveals no adverse public notices...",
"sources": ["https://registroimprese.it/innovazione", "https://azienda-innovativa.it"]
}
The administrator approves the calculated report and publishes the score. This triggers a webhook that updates the locked corporate VCard and propagates the status to Shartify.one.
{
"node_alias": "azienda-innovativa",
"publish": true
}
Success Response:
{
"success": true,
"published_url": "https://shartify.one/nodes/azienda-innovativa",
"message": "Trust Rank published successfully to Shartify.one."
}
Secure resolution of the professional verified profile. This endpoint strictly requires a valid XCircle session token in the authorization header, preventing unauthenticated public access to sensitive audit trails.
Authorization: Bearer XCIRCLE_SESSION_TOKENSuccess Response:
{
"success": true,
"node": {
"alias": "azienda-innovativa",
"title": "Azienda Innovativa S.r.l.",
"trust_rank": 8.7,
"kyc_status": "verified",
"guarantors": [
{
"name": "Dr. Mario Rossi",
"email": "[email protected]",
"responses_count": 2
}
],
"audit_trail": [
{
"action": "pre_registration",
"timestamp": "2026-06-19 14:22:10"
},
{
"action": "guarantor_responses",
"timestamp": "2026-06-19 15:45:00"
},
{
"action": "rank_calculated",
"value": 8.7,
"timestamp": "2026-06-19 16:10:00"
}
]
}
}
Autonomous AI agents operating within the INXA network can directly invoke these operations using the Model Context Protocol (MCP) definitions exposed at `/api/mcp/tools`. Registered Shartify tools include:
shartify_register_node
Allows an agent to pre-register a business node by providing public metadata and guarantor emails.
shartify_get_node_status
Retrieves the current audit state of a node, including pending questions and final rankings.
shartify_submit_response
Enables a guarantor agent to submit certified replies on behalf of the represented enterprise.
shartify_calculate_rank
Enables an admin agent to trigger the combined LLM and web-search calculation process.