The Add-On system enables FRAKTIΛ agents to interface with external services via containerized plug-ins. These Add-Ons communicate over the Model Context Protocol (MCP) — a JSON-RPC 2.0-based protocol optimized for agent interaction.

Structure Overview

✦ Each Add-On runs as an isolated microservice.
✦ Bound to agents via addon.json manifest.
✦ Agent interacts via mcp.call(...), mcp.subscribe(...) or event-driven hooks.

Example: Add-On Manifest (addon.json)

{
  "name": "DeFi Sniper Bot",
  "version": "1.0.0",
  "description": "Executes buy/sell operations based on token signals",
  "methods": ["triggerBuy", "triggerSell"],
  "events": ["priceAbove", "priceBelow"],
  "endpoint": "https://addons.fraktia.ai/sniper/v1",
  "auth": {
    "type": "bearer",
    "token": "{{agent.apiKey}}"
  }
}

Example: Agent calling Add-On method

{
  "jsonrpc": "2.0",
  "method": "triggerBuy",
  "params": {
    "token": "WETH",
    "amount": "1.2",
    "slippage": "0.3"
  },
  "id": 42
}

Use this when:

✦ Your agent needs to talk to an external system. (Web2 API, Web3 contract, robotics interface)
✦ You want to isolate business logic into a microservice.
✦ You want to publish your Add-On into the FRAKTIΛ Marketplace.