MCP Bridges & Tools

Niyatna OS executes tools via Model Context Protocol (MCP) bridges. This design wraps raw command lines and APIs into structured, inspectable interfaces.

Supported MCP Integrations

• Filesystem Bridge: Mounts scoped workspace directories, logging reads, writes, and file creations.
• Terminal Sandbox: Runs compile commands, tests, and scripts in isolated environments.
• LocalRoute Bridge: Communicates with model API gateways, encrypting and masking authorization keys.
• Office / CRM Bridge: Syncs CRM statuses (HubSpot) and emails under specific validation rules.
• Ledger Bridge: Integrates transaction ledgers (Stripe) to finance runtimes under read-only scoping.

Event Schema

Every tool call returns a structured schema back to Niyatna OS:

{
  "intent_id": "niyatna-task-0248",
  "mcp_server": "filesystem",
  "tool_invoked": "write_file",
  "arguments": { "path": "/app/page.tsx" },
  "status": "success",
  "evidence_path": "file:///workspace/patch.diff",
  "requires_approval": true
}