// MCP TOOL REFERENCE

ATTIO TOOLS

57 tools from the Attio MCP Server, categorised by risk level.

View the Attio policy →
// ALL 57 ATTIO TOOLS
READ 27 tools
Read getv2attributes Lists all attributes defined on a specific object or list. Attributes are returned in the order that they a... Read getv2attributesbyattribute Gets information about a single attribute on either an object or a list. Required scopes: \ Read getv2attributesoptions Lists all select options for a particular attribute on either an object or a list. Required scopes: \ Read getv2attributesstatuses Lists all statuses for a particular status attribute on either an object or a list. Required scopes: \ Read getv2commentsbycommentid Get a single comment by ID. To view comments on records, you will need the \ Read getv2lists List all lists that your access token has access to. lists are returned in the order that they are sorted i... Read getv2listsbylist Gets a single list in your workspace that your access token has access to. Required scopes: \ Read getv2listsentriesattributesvalues Gets all values for a given attribute on a list entry. If the attribute is historic, this endpoint has the ... Read getv2listsentriesbyentryid Gets a single list entry by its \ Read getv2notes List notes for all records or for a specific record. Required scopes: \ Read getv2notesbynoteid Get a single note by ID. Required scopes: \ Read getv2objects Lists all system-defined and user-defined objects in your workspace. Required scopes: \ Read getv2objectsbyobject Gets a single object by its \ Read getv2objectsrecordsattributesvalues Gets all values for a given attribute on a record. If the attribute is historic, this endpoint has the abil... Read getv2objectsrecordsbyrecordid Gets a single person, company or other record by its \ Read getv2objectsrecordsentries List all entries, across all lists, for which this record is the parent. Required scopes: \ Read getv2self Identify the current access token, the workspace it is linked to, and any permissions it has. Read getv2tasks List all tasks. Results are sorted by creation date, from oldest to newest. Required scopes: \ Read getv2tasksbytaskid Get a single task by ID. Required scopes: \ Read getv2threads List threads of comments on a record or list entry. To view threads on records, you will need the \ Read getv2threadsbythreadid Get all comments in a thread. To view threads on records, you will need the \ Read getv2webhooks Get all of the webhooks in your workspace. Required scopes: \ Read getv2webhooksbywebhookid Get a single webhook. Required scopes: \ Read getv2workspacemembers Lists all workspace members in the workspace. Required scopes: \ Read getv2workspacemembersbyworkspacememberid Gets a single workspace member by ID. Required scopes: \ Read postv2listsentriesquery Lists entries in a given list, with the option to filter and sort results. Required scopes: \ Read postv2objectsrecordsquery Lists people, company or other records, with the option to filter and sort results. Required scopes: \
WRITE 24 tools
Write patchv2attributesbyattribute Updates a single attribute on a given object or list. Required scopes: \ Write patchv2attributesoptionsbyoption Updates a select option on an attribute on either an object or a list. Required scopes: \ Write patchv2listsbylist Updates an existing list. Permissions for the list are controlled with the \ Write patchv2objectsbyobject Updates a single object. The object to be updated is identified by its \ Write patchv2tasksbytaskid Updates an existing task by \ Write postv2attributesoptions Adds a select option to a select attribute on an object or a list. Required scopes: \ Write postv2listsentries Adds a record to a list as a new list entry. This endpoint will throw on conflicts of unique attributes. Mu... Write postv2notes Creates a new note for a given record. Required scopes: \ Write postv2objects Creates a new custom object in your workspace. Required scopes: \ Write postv2tasks Creates a new task. At present, tasks can only be created from plaintext without record reference formatti... Write patchv2attributesstatusesbystatus Update a status on an status attribute on either an object or a list. Required scopes: \ Write patchv2listsentriesbyentryid Use this endpoint to update list entries by \ Write patchv2objectsrecordsbyrecordid Use this endpoint to update people, companies, and other records by \ Write patchv2webhooksbywebhookid Update a webhook and associated subscriptions. Required scopes: \ Write postv2attributes Creates a new attribute on either an object or a list. To create an attribute on an object, you must also ... Write postv2attributesstatuses Add a new status to a status attribute on either an object or a list. Required scopes: \ Write postv2comments Creates a new comment related to an existing thread, record or entry. To create comments on records, you w... Write postv2lists Creates a new list. Once you have your list, add attributes to it using the [Create attribute](/rest-api/e... Write postv2objectsrecords Creates a new person, company or other record. This endpoint will throw on conflicts of unique attributes. ... Write postv2webhooks Create a webhook and associated subscriptions. Required scopes: \ Write putv2listsentries Use this endpoint to create or update a list entry for a given parent record. If an entry with the specifie... Write putv2listsentriesbyentryid Use this endpoint to update list entries by \ Write putv2objectsrecords Use this endpoint to create or update people, companies and other records. A matching attribute is used to ... Write putv2objectsrecordsbyrecordid Use this endpoint to update people, companies, and other records by \
DESTRUCTIVE 6 tools
Destructive deletev2notesbynoteid Delete a single note by ID. Required scopes: \ Destructive deletev2tasksbytaskid Delete a task by ID. Required scopes: \ Destructive deletev2webhooksbywebhookid Delete a webhook by ID. Required scopes: \ Destructive deletev2commentsbycommentid Deletes a comment by ID. If deleting a comment at the head of a thread, all messages in the thread are also... Destructive deletev2listsentriesbyentryid Deletes a single list entry by its \ Destructive deletev2objectsrecordsbyrecordid Deletes a single record (e.g. a company or person) by ID. Required scopes: \

Route Attio through PolicyLayer and every one of its 57 tools is checked against your policy before it runs.

CHECK YOUR STACK →

See every tool, the dangerous ones, and the token cost across your stack.

// FAQ
How many tools does the Attio MCP server have? +

The Attio MCP server exposes 57 tools across 3 categories: Read, Write, Destructive.

How do I enforce policies on Attio tools? +

Route the Attio server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do Attio tools fall into? +

Attio tools are categorised as Read (27), Write (24), Destructive (6). Each category has a recommended default policy.

Enforce policy on every Attio tool call.

Start from Attio, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.