# Coil

> Public documentation for Coil's UI, workspace-scoped API, and remote MCP server.

Documentation is public. API/MCP execution requires a scoped workspace key. Do not ask users to paste credentials in chat, and do not execute example writes automatically.

## Start Here

- [Agent Setup](https://www.usecoil.app/docs/agents): Client capabilities, credentials, discovery, least-privilege configuration, and a read-only first task.
- [API and MCP Reference](https://www.usecoil.app/docs/api): Searchable generated tool contracts and examples.
- [JSON Contracts](https://www.usecoil.app/docs/api.json): Full public operation metadata and JSON input schemas. Live authenticated discovery may expose fewer tools.
- [Full Text](https://www.usecoil.app/llms-full.txt): All guides plus generated tool contracts without HTML.

## Guides

- [Coil Documentation](https://www.usecoil.app/docs): Set up your workspace, run daily operations, and connect agents to Coil's API and MCP tools.
- [Inventory and Purchasing](https://www.usecoil.app/docs/inventory): Receive purchases, track expiration, and keep warehouse and machine stock consistent.
- [Sales and Sales Tax](https://www.usecoil.app/docs/sales): Import vendor sales reports, record sales by hand, track sales tax owed, and match sales to stock.
- [Receipts and Expenses](https://www.usecoil.app/docs/receipts): Preserve originals, classify purchases, link lots, and resolve exact-file duplicates.
- [Machines and Restock Visits](https://www.usecoil.app/docs/machines): Set up locations and machines, review product targets, and separate movement from sales.
- [Reports, Mileage, and Audits](https://www.usecoil.app/docs/reports): Use Coil's calculations, record trips, and inspect the effects of agent changes.
- [Connect an Agent](https://www.usecoil.app/docs/agents): Configure any MCP or API client to use Coil safely across reads, purchasing, operations, reporting, and audits.
- [Permissions and Presets](https://www.usecoil.app/docs/permissions): Choose task-specific access without giving agents blanket control of the workspace.
- [Agent Workflows](https://www.usecoil.app/docs/workflows): Read, review, and apply changes with stable requests, current versions, and clear effects.
- [Troubleshooting](https://www.usecoil.app/docs/troubleshooting): Resolve connection, permission, version, upload, and retry failures without bypassing safeguards.

## Operational Rules

- Discover only the tools permitted by the configured key. Documentation grants no permissions.
- Start with reads. Show changes before writing. Use current record versions and reviewed preview IDs where required.
- Reuse request IDs and identical inputs for write retries. Reconcile pending/uncertain outcomes instead of bypassing them with new IDs.
- Original file uploads additionally require actual byte access, a binary HTTP client/shell, and an allowlisted upload host. Do not reconstruct originals.
- Team access, key management, billing, global moderation, and removal reasons other than giveaways are not exposed to agents. Giveaways require inventory:giveaway and a reviewed preview.