MCP Server

Forge Box exposes an MCP server that allows AI agents to interact with AgentEndpoint and AgentOS directly. Every tool call returns a signed receipt.

Authentication

All MCP tools require authentication via:

• API Key — Pass X-API-Key header
• OAuth 2.0 — PKCE flow with scopes: read, write, execute, sandbox, purchase, support, admin

AgentEndpoint Tools

Tool	Description	Input
get_pricing	Get current pricing tiers	none
create_account	Create a new account	email
create_workflow	Create a workflow	name, description
list_workflows	List workflows	none
execute_workflow	Execute a workflow	workflow_id, input
request_refund	Request a refund	order_id, reason
cancel_subscription	Cancel subscription	subscription_id
open_support_ticket	Open support ticket	subject, body
escalate_to_human	Escalate to human	ticket_id, context

AgentOS Tools

Tool	Description	Input
sandbox_run	Run code in sandbox	code, language
sandbox_evaluate	Evaluate policy for action	action object
get_risk_score	Get risk score (0-100)	action_type, target
list_sandbox_runs	List sandbox runs	none

Example (curl)

curl -X POST https://mcp.agentforge.dev/tools/call \
  -H "Authorization: Bearer af_liv..." \
  -H "Content-Type: application/json" \
  -d '{"name": "get_pricing", "arguments": {}}'

Example (TypeScript)

import { Client } from "@modelcontextprotocol/sdk/client/index.js";

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);

const result = await client.callTool("execute_workflow", {
  workflow_id: "wf_abc123",
  input: { order_id: "ORD-456" }
});
console.log(result.receipt); // Signed receipt

Response Format

All tool calls that execute actions return a signed receipt:

{
  "execution_id": "exec_abc123",
  "status": "completed",
  "duration_ms": 87,
  "cost_usd": 0.002,
  "receipt": {
    "id": "rcpt_def456",
    "timestamp": "2026-06-11T03:23:45Z",
    "signature": "ed25519:9f2c...",
    "verified": true
  }
}