ifivo MCP server
The ifivo MCP server exposes your org's agent control plane to any MCP-compatible assistant — ChatGPT, Claude, Gemini, and more. Configure policies, review approvals, engage the kill switch, and summarize daily activity conversationally.
1. Get your org API key
Sign in, open Settings, and copy the token starting with ifv_.
2. Endpoint
POST https://www.ifivo.com/api/mcp Authorization: Bearer ifv_… Content-Type: application/json
Transport: Streamable HTTP MCP (JSON-RPC 2.0). Supports initialize, tools/list, and tools/call.
3. Configure your assistant
ChatGPT (Enterprise / Team admin)
Admin panel → Connectors → Add custom MCP. Paste the URL and token, or import this JSON:
{
"name": "ifivo",
"type": "mcp",
"url": "https://www.ifivo.com/api/mcp",
"authorization": "Bearer ifv_YOUR_ORG_KEY"
}Claude (Desktop or Claude.ai)
Desktop: edit ~/Library/Application Support/Claude/claude_desktop_config.json. Claude.ai: Settings → Connectors → Add MCP server.
{
"mcpServers": {
"ifivo": {
"url": "https://www.ifivo.com/api/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer ifv_YOUR_ORG_KEY"
}
}
}
}Gemini
Use the Gemini MCP client to register the HTTPS endpoint:
// @google/genai MCP client
import { McpClient } from "@google/genai/mcp";
const ifivo = new McpClient({
url: "https://www.ifivo.com/api/mcp",
headers: { Authorization: "Bearer ifv_YOUR_ORG_KEY" },
});
await ifivo.connect();
const tools = await ifivo.listTools();Test from your terminal
curl -sS -X POST https://www.ifivo.com/api/mcp \
-H "Authorization: Bearer ifv_YOUR_ORG_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"summarize_today","arguments":{}}}'4. Tools exposed
list_agents— status, budget, spendlist_transactions— filter by status/agentlist_pending_approvalsapprove_transaction/deny_transactionengage_org_kill_switch/release_org_kill_switchquarantine_agentcreate_policy— deterministic rules (AND semantics)summarize_today— natural-language daily recap
5. Example prompts (once connected)
- “What did our agents do today?”
- “Show me any pending approvals over $1,000.”
- “Approve the refund for invoice inv_123.”
- “Quarantine the marketing-adbuyer agent.”
- “Create a policy: any OpenAI call above $100 requires approval.”