attio-mcp-usage

The Attio MCP Usage skill serves as a comprehensive operational manual for developers and AI agents interacting with Attio workspaces via the Model Context Protocol (MCP). While schema-specific skills handle the 'what'—such as identifying your unique workspace attribute slugs, list IDs, and custom field types—this skill focuses on the 'how,' providing the universal logic, structural patterns, and architectural safeguards required to execute complex CRM operations reliably. It is designed for engineers and power users building integrations or automating CRM workflows who need to move beyond raw API calls into structured, multi-step agentic interactions.

• Standardized workflow patterns for multi-step CRM operations, ensuring consistent execution across diverse business logic.

• An extensive error prevention system ('Golden Rules') designed to preempt common API failures and data synchronization issues.

• Deep integration guidance for managing Attio resources including Deals, Tasks, Companies, People, and Lists through consolidated universal tools.

• Pattern selection routing to help agents and developers identify the most efficient tool sequences for specific CRM outcomes.

• Architectural best practices for high-performance data operations, leveraging the server's optimized architecture and batching capabilities.

• Use this skill to structure complex workflows such as multi-stage pipeline management or cross-object relationship discovery between companies and people.

• Always cross-reference this usage guide with your workspace-specific schema skill to ensure that record field updates, list membership changes, and filter queries use valid identifiers.

• Consult the tool reference for proper syntax when invoking universal operations; favor consolidated tools over deprecated legacy methods to ensure long-term maintenance and compatibility.

• Pay close attention to the error prevention guidelines when performing batch writes or large-scale data updates to mitigate the risk of mutating the wrong objects.

• This skill acts as a bridge between the raw technical capabilities of the Attio MCP server and the practical, day-to-day requirements of maintaining a clean and accurate CRM pipeline.