MCP and App Tools
How Forger separates app-owned MCP tools, Forger Tools, Connections, validation, and visible features.
MCP is the structured interface Forger uses when an agent needs to operate app data or platform capabilities. It gives the agent named operations with declared inputs, outputs, permissions, and validation instead of asking the agent to guess how a screen, database, script, or endpoint works.
Forger treats tools as an agent-facing operating layer. The person experiences the result in product terms: what was found, what changed, what needs permission, and what cannot be done with the current app or access level.
What Tools Are
Tools are controlled capabilities that an agent can call during a task. They can read records, validate input, create data, update data, start a supported operation, or operate a platform capability when the app and platform allow it.
A tool is not automatically a user-visible feature. The visible feature is the workflow or outcome the person understands, such as importing messages, reviewing customer notes, updating a plan, or sending an approved reply. The tool is the structured mechanism the agent uses behind that workflow.
App Data Tools
App data tools belong to the installed app. They reflect the app's real model, validation rules, and domain language so the agent can work with app-owned data without bypassing the backend or writing directly to storage.
When app data tools exist, they are the normal path for agent work. Direct database edits, ad hoc scripts, or undocumented endpoints remain fallback mechanisms for technical work, not the normal path for a supported app workflow.
Forger Tools
Forger Tools are platform-owned capabilities that sit outside one app's data model. They include Desktop operations, Workflows, Memory, the Forger Chrome Extension, app lifecycle actions, and other Forger-owned services that an app or agent can request for a visible task.
Forger Tools remain separate from app data tools. An app can ask Forger for access to a platform capability, but Desktop owns the permission boundary, availability checks, and safe execution path.
Connections
Connections are external accounts, workspaces, services, or sessions that the person connects in Forger. Gmail, Google Calendar, Google Sheets, Google Drive, Google Docs, GitHub, Notion, WhatsApp, Slack, and Trello accounts or workspaces are Connections, not Forger Tools.
A Connection can have its own setup flow, status, selected account or session, default, grants, and approval requirements. Apps declare this access with manifest.connections, including the connection type, user-visible reason, allowed actions, and whether multiple accounts or sessions can be used.
Registered Connections
External account and workspace access is granted through Connections, not by giving an app broad account access. A manifest connection grant explains the user-visible reason and requests only the actions the app needs for the declared workflow.
This access is used for work the app cannot perform without that external service. If access is unavailable, disconnected, ambiguous, or denied, Forger explains the functional impact, such as not being able to read selected messages, draft a reply, post an update, or sync a conversation.
Permissions
Permissions connect a visible app workflow to the specific operations an agent may use. Narrow and explainable permissions make it clear why the app needs access and how that access relates to the current capability.
Permission copy describes what the person gets from the access, not the internal transport. The person does not need to understand MCP server names, manifest fields, endpoints, environment variables, or local paths to decide whether an app can use a tool or Connection.
Safe Data Changes
Tools and Connection actions that change data validate before committing changes and return structured errors the agent can translate into clear guidance. Missing fields, invalid values, duplicate records, unsupported operations, permission denial, ambiguous account selection, and partial failures produce specific user-facing explanations.
Destructive or hard-to-reverse changes use explicit confirmation when the workflow requires it. When preview, apply, and undo flows are available, the person can inspect the impact before the app changes important data.
Why Tools Are Not UI
Tools and Connections are not the app interface. They are how the agent operates approved capabilities while the person uses screens, chat, confirmations, progress states, and results.
Documentation and product copy present the workflow outcome, not tool calls as manual steps. When a person asks what happened, Forger explains the outcome and the safety boundary first, then exposes implementation details only when they are useful for debugging or technical review.