Facio Blog

Practical notes on human-reviewed AI agents.

Payload-powered product notes, security writing, HITL patterns, and operational guidance from the Facio runtime: long sessions, Placet approvals, audit trails, memory, providers, channels, tools, and Docker-first operations.

Showing 1-5 of 62 articles in Engineering.

Engineering

MCP Server Authoring Guide 2026: Building Production-Grade MCP Servers From Scratch — The Authoring Playbook Every Independent Server Author Should Follow

The 12 decisions every MCP server author must make: transport, SDK, license, auth, secrets, tool surface, output format, error handling, rate limiting, idempotency, distribution, documentation. Plus standard patterns (pagination, search, bulk, async, webhooks), security hardening, testing strategy, versioning, and the publishing checklist.

Jul 21, 2026Engineering

Read article

Engineering

MCP Spotlight: GitHub MCP Server — The Official Code-and-Collaboration Bridge With Fine-Grained PATs, PR/Issue Workflows, and the Engineering-Workflow Default for Agents

Jul 20, 2026Engineering

MCP Spotlight: GitHub MCP Server — The Official Code-and-Collaboration Bridge With Fine-Grained PATs, PR/Issue Workflows, and the Engineering-Workflow Default for Agents

The official GitHub MCP Server by GitHub — ~40 focused tools covering issues, PRs, code, commits, branches, Actions, releases, reviews, security alerts. Fine-Grained Personal Access Token support for per-repo + per-action scope isolation. Branch-protection-aware merge control. MIT-licensed. The code-collaboration default for AI agents in 2026.

Engineering

MCP Spotlight: Docker MCP Server — The Container Operations Bridge With `mcp://` Catalog Protocol, MCP Toolkit, and the Container-Default Reference for Agents

Jul 19, 2026Engineering

MCP Spotlight: Docker MCP Server — The Container Operations Bridge With `mcp://` Catalog Protocol, MCP Toolkit, and the Container-Default Reference for Agents

Docker's official MCP infrastructure — the Docker Hub MCP Catalog (300+ verified servers with signatures + provenance), the MCP Toolkit (isolated runtime execution via Docker MCP Gateway), and the mcp:// URL protocol for declarative installation. Apply container-ecosystem primitives (signing, isolation, secrets, orchestration) to MCP.

Engineering

MCP Spotlight: Resend MCP Server — The Email Bridge With 10 Tool Groups, Send/Receive Symmetry, and the Transactional-Default Reference for Agents

Jul 18, 2026Engineering

MCP Spotlight: Resend MCP Server — The Email Bridge With 10 Tool Groups, Send/Receive Symmetry, and the Transactional-Default Reference for Agents

The official Resend MCP Server by Resend — ~25 tools across 10 domain groups covering emails, contacts, broadcasts, domains, webhooks, segments, topics, contact properties, API keys, received emails. Send/receive symmetry, Topics for GDPR preference management, hosted at mcp.resend.dev or self-hosted via NPX. MIT-licensed.

Engineering

MCP Spotlight: Notion MCP Server — The Official Knowledge-Base Bridge With Markdown-Native Retrieval, Two-Tool Minimalism, and the Workspace-Context Default for Agents

Jul 17, 2026Engineering

MCP Spotlight: Notion MCP Server — The Official Knowledge-Base Bridge With Markdown-Native Retrieval, Two-Tool Minimalism, and the Workspace-Context Default for Agents

The official Notion MCP Server by Notion — 2 tools in the minimal profile (notion-search, notion-fetch), Markdown-native retrieval (12x token savings vs raw JSON), OAuth 2.0 with principle-of-least-privilege scopes, full CRUD available in the standard profile. MIT-licensed. The knowledge-base default for AI agents in 2026.