Servers Playground How we check Add a server Log in

Aircall MCP by usefulapi

Working · 2.4 s

io.usefulapi/aircallv1.21.0 Domain verified

Read calls, contacts, users, teams and numbers; tag calls and create or update contacts.

Communication Sales & CRM

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://aircall.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

aircall_add_call_comment Destructive

Add a comment / note to a call. Aircall REST: POST /calls/{id}/comments.

idinteger, required

The call id to comment on.

contentstring, required

The comment text (required).

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Aircall MCP by usefulapi MCP server | mcptry

Tools (25)

aircall_add_call_comment

Add a comment / note to a call. Aircall REST: POST /calls/{id}/comments.

destructive

Argument	Type	Description
id*	integer	The call id to comment on.
content*	string	The comment text (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id",
    "content"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The call id to comment on."
    },
    "content": {
      "type": "string",
      "description": "The comment text (required)."
    }
  }
}

aircall_create_contact

Create a new contact in the shared address book. Aircall typically requires at least one of first_name / last_name / company_name. Aircall REST: POST /contacts.

destructive

Argument	Type	Description
emails	array	Email addresses for the contact, each { label, value }.
last_name	string	The contact's last name.
first_name	string	The contact's first name.
information	string	Freeform notes about the contact.
company_name	string	The contact's company name.
phone_numbers	array	Phone numbers for the contact, each { label, value }.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "label",
          "value"
        ],
        "properties": {
          "label": {
            "type": "string",
            "description": "Label for the entry, e.g. 'Work', 'Home', 'Mobile'."
          },
          "value": {
            "type": "string",
            "description": "The phone number or email address."
          }
        },
        "description": "A labelled contact detail entry."
      },
      "description": "Email addresses for the contact, each { label, value }."
    },
    "last_name": {
      "type": "string",
      "description": "The contact's last name."
    },
    "first_name": {
      "type": "string",
      "description": "The contact's first name."
    },
    "information": {
      "type": "string",
      "description": "Freeform notes about the contact."
    },
    "company_name": {
      "type": "string",
      "description": "The contact's company name."
    },
    "phone_numbers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "label",
          "value"
        ],
        "properties": {
          "label": {
            "type": "string",
            "description": "Label for the entry, e.g. 'Work', 'Home', 'Mobile'."
          },
          "value": {
            "type": "string",
            "description": "The phone number or email address."
          }
        },
        "description": "A labelled contact detail entry."
      },
      "description": "Phone numbers for the contact, each { label, value }."
    }
  }
}

aircall_get_call

Get a single call by id. Aircall REST: GET /calls/{id}.

read-only

Argument	Type	Description
id*	integer	The call id.
fetch_contact	boolean	If true, include the full contact details for the call.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The call id."
    },
    "fetch_contact": {
      "type": "boolean",
      "description": "If true, include the full contact details for the call."
    }
  }
}

aircall_get_call_action_items

Get the AI-extracted action items / follow-ups from a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/action_items.

read-only

Argument	Type	Description
id*	integer	The call id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The call id."
    }
  }
}

aircall_get_call_sentiments

Get the AI-generated sentiment analysis of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/sentiments.

read-only

Argument	Type	Description
id*	integer	The call id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The call id."
    }
  }
}

aircall_get_call_summary

Get the AI-generated summary of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/summary.

read-only

Argument	Type	Description
id*	integer	The call id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The call id."
    }
  }
}

aircall_get_call_topics

Get the AI-detected topics of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/topics.

read-only

Argument	Type	Description
id*	integer	The call id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The call id."
    }
  }
}

aircall_get_call_transcription

Get the AI-generated transcription of a call (Aircall AI Voice feature). Aircall REST: GET /calls/{id}/transcription.

read-only

Argument	Type	Description
id*	integer	The call id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The call id."
    }
  }
}

aircall_get_company

Get details of the authenticated Aircall company (name, plan, usage). Aircall REST: GET /company.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

aircall_get_contact

Get a single contact by id. Aircall REST: GET /contacts/{id}.

read-only

Argument	Type	Description
id*	integer	The contact id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The contact id."
    }
  }
}

aircall_get_number

Get a single phone number by id. Aircall REST: GET /numbers/{id}.

read-only

Argument	Type	Description
id*	integer	The number id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The number id."
    }
  }
}

aircall_get_tag

Get a single tag by id. Aircall REST: GET /tags/{id}.

read-only

Argument	Type	Description
id*	integer	The tag id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The tag id."
    }
  }
}

aircall_get_team

Get a single team by id. Aircall REST: GET /teams/{id}.

read-only

Argument	Type	Description
id*	integer	The team id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The team id."
    }
  }
}

aircall_get_user

Get a single user (agent) by id. Aircall REST: GET /users/{id}.

read-only

Argument	Type	Description
id*	integer	The user id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The user id."
    }
  }
}

aircall_list_calls

List calls, optionally filtered by a creation-date window and ordered. Aircall REST: GET /calls.

read-only

Argument	Type	Description
to	string	Maximal creation date — a UNIX timestamp or ISO 8601 string.
from	string	Minimal creation date — a UNIX timestamp or ISO 8601 string.
page	integer	1-based page number to fetch (default 1).
order	string	Sort order by creation date — 'asc' or 'desc' (default asc).
per_page	integer	Results per page (default 20, max 50).
fetch_contact	boolean	If true, include the full contact details of each call.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "to": {
      "type": "string",
      "description": "Maximal creation date — a UNIX timestamp or ISO 8601 string."
    },
    "from": {
      "type": "string",
      "description": "Minimal creation date — a UNIX timestamp or ISO 8601 string."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number to fetch (default 1)."
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort order by creation date — 'asc' or 'desc' (default asc)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page (default 20, max 50)."
    },
    "fetch_contact": {
      "type": "boolean",
      "description": "If true, include the full contact details of each call."
    }
  }
}

aircall_list_contacts

List contacts in the shared address book, optionally by creation-date window and order. Aircall REST: GET /contacts.

read-only

Argument	Type	Description
to	string	Maximal creation date — a UNIX timestamp or ISO 8601 string.
from	string	Minimal creation date — a UNIX timestamp or ISO 8601 string.
page	integer	1-based page number to fetch (default 1).
order	string	Sort order by creation date — 'asc' or 'desc' (default asc).
per_page	integer	Results per page (default 20, max 50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "to": {
      "type": "string",
      "description": "Maximal creation date — a UNIX timestamp or ISO 8601 string."
    },
    "from": {
      "type": "string",
      "description": "Minimal creation date — a UNIX timestamp or ISO 8601 string."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number to fetch (default 1)."
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort order by creation date — 'asc' or 'desc' (default asc)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page (default 20, max 50)."
    }
  }
}

aircall_list_numbers

List the phone numbers owned by the company (id, name, digits, country). Aircall REST: GET /numbers.

read-only

Argument	Type	Description
page	integer	1-based page number to fetch (default 1).
per_page	integer	Results per page (default 20, max 50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number to fetch (default 1)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page (default 20, max 50)."
    }
  }
}

aircall_list_tags

List the company's call tags (id, name, color). Aircall REST: GET /tags.

read-only

Argument	Type	Description
page	integer	1-based page number to fetch (default 1).
per_page	integer	Results per page (default 20, max 50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number to fetch (default 1)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page (default 20, max 50)."
    }
  }
}

aircall_list_teams

List the company's teams and their members. Aircall REST: GET /teams.

read-only

Argument	Type	Description
page	integer	1-based page number to fetch (default 1).
per_page	integer	Results per page (default 20, max 50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number to fetch (default 1)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page (default 20, max 50)."
    }
  }
}

aircall_list_users

List users (agents) in the Aircall company (id, name, email, availability). Aircall REST: GET /users.

read-only

Argument	Type	Description
page	integer	1-based page number to fetch (default 1).
per_page	integer	Results per page (default 20, max 50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number to fetch (default 1)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page (default 20, max 50)."
    }
  }
}

aircall_ping

Health check — verify the API is reachable and the credentials are valid. Aircall REST: GET /ping.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

aircall_search_calls

Search calls by a free-text term (e.g. phone number, tag, direction). Aircall REST: GET /calls/search.

read-only

Argument	Type	Description
q	string	Search term to match calls against.
page	integer	1-based page number to fetch (default 1).
per_page	integer	Results per page (default 20, max 50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search term to match calls against."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number to fetch (default 1)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page (default 20, max 50)."
    }
  }
}

aircall_search_contacts

Search contacts by a free-text term (e.g. name, phone number, email). Aircall REST: GET /contacts/search.

read-only

Argument	Type	Description
q	string	Search term to match contacts against.
page	integer	1-based page number to fetch (default 1).
per_page	integer	Results per page (default 20, max 50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search term to match contacts against."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number to fetch (default 1)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page (default 20, max 50)."
    }
  }
}

aircall_tag_call

Apply tags to a call by tag id (get ids from aircall_list_tags). Aircall REST: POST /calls/{id}/tags.

destructive

Argument	Type	Description
id*	integer	The call id to tag.
tag_ids*	array	Ids of the tags to apply (from aircall_list_tags) (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id",
    "tag_ids"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The call id to tag."
    },
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": -9007199254740991
      },
      "description": "Ids of the tags to apply (from aircall_list_tags) (required)."
    }
  }
}

aircall_update_contact

Update fields on an existing contact. Only provided fields are changed. Aircall REST: PUT /contacts/{id}.

destructive

Argument	Type	Description
id*	integer	The contact id to update.
emails	array	Replace the contact's email addresses, each { label, value }.
last_name	string	The contact's last name.
first_name	string	The contact's first name.
information	string	Freeform notes about the contact.
company_name	string	The contact's company name.
phone_numbers	array	Replace the contact's phone numbers, each { label, value }.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The contact id to update."
    },
    "emails": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "label",
          "value"
        ],
        "properties": {
          "label": {
            "type": "string",
            "description": "Label for the entry, e.g. 'Work', 'Home', 'Mobile'."
          },
          "value": {
            "type": "string",
            "description": "The phone number or email address."
          }
        },
        "description": "A labelled contact detail entry."
      },
      "description": "Replace the contact's email addresses, each { label, value }."
    },
    "last_name": {
      "type": "string",
      "description": "The contact's last name."
    },
    "first_name": {
      "type": "string",
      "description": "The contact's first name."
    },
    "information": {
      "type": "string",
      "description": "Freeform notes about the contact."
    },
    "company_name": {
      "type": "string",
      "description": "The contact's company name."
    },
    "phone_numbers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "label",
          "value"
        ],
        "properties": {
          "label": {
            "type": "string",
            "description": "Label for the entry, e.g. 'Work', 'Home', 'Mobile'."
          },
          "value": {
            "type": "string",
            "description": "The phone number or email address."
          }
        },
        "description": "A labelled contact detail entry."
      },
      "description": "Replace the contact's phone numbers, each { label, value }."
    }
  }
}