Lists the calls made and received with the org's phone lines, newest first, paginated by cursor (limit up to 200, default 25): direction, status, from/to and the other party's number (a call from the app's dialer comes from its line's number), the owner and who answered with their names, when it started, was answered and ended, duration, voicemail, whether it was recorded, the linked person, deal, company or prospect, the seller's notes and disposition, and the CRM activity it created. Filter by one of line_id, owner_id, deal_id or direction, plus a since/until range on the creation time. Recordings and costs are not included. Module: Phones (crm_phones), even though the id starts with crm.; the credential needs the crm_phones:read scope.
Escopo
crm_phones:read
Permissão
Ver o módulo
Tool do MCP
crm_calls_listNa superfície completa; na compacta, mb_execute_operation com id: "crm.calls.list".
Custo declarado: até 202 leituras e 0 escritas por chamada (contam na cota diária).
Parâmetros
limitintegerqueryopcional
How many items this page brings at most (see the maximum and the default in the schema).
Padrão: 25
cursorstringqueryopcional
The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
line_idstringqueryopcional
Only the calls of this phone line: an id from crm_phones.lines.list.
owner_idstringqueryopcional
Only the calls of this member (the seller who made or took them): a user_id from crm.team.list.
deal_idstringqueryopcional
Only the calls linked to this deal (crm.deals.list).
directionenumqueryopcional
inbound, outbound-api (from an automation or the voice agent) or outbound-dial (from the app's dialer).
Valores: inbound, outbound-api, outbound-dial
sinceintegerqueryopcional
Only the calls created from this time on (epoch ms, inclusive).
untilintegerqueryopcional
Only the calls created up to this time (epoch ms, inclusive).
Saves the seller's notes (up to 5,000 characters) and the disposition of a call: sale, follow_up, voicemail, no_answer, wrong_number or other. Both go to the call and to its CRM activity (notes become the activity description, the disposition sets the call outcome), creating the activity if the call matches a person or deal. unlinked: true means the call matches nothing in the CRM: link it with crm.calls.link_entity. Requires full access to Phones. Module: Phones (crm_phones), even though the id starts with crm.; the credential needs the crm_phones:write scope.
Escopo
crm_phones:write
Permissão
Editar no módulo
Tool do MCP
crm_calls_save_outcomeNa superfície completa; na compacta, mb_execute_operation com id: "crm.calls.save_outcome".
Custo declarado: até 12 leituras e 30 escritas por chamada (contam na cota diária).
Parâmetros
call_sidstringrotaobrigatório
The call: its id (Twilio's call_sid) from crm.calls.list.
notesstringcorpoopcional
The seller's notes (up to 5,000 characters); they become the call activity's description.
dispositionenumcorpoopcional
How the call ended: sale, follow_up, voicemail, no_answer, wrong_number or other.
Valores: sale, follow_up, voicemail, no_answer, wrong_number, other
curl-X POST "https://api.mb-suite.com/v1/crm/calls/{call_sid}/outcome" \
-H"Authorization: Bearer $MB_API_KEY"
Testar com a sua API key de teste
Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.
curl-X POST "https://api.mb-suite.com/v1/crm/calls/{call_sid}/outcome" \
-H"Authorization: Bearer $MB_TEST_KEY"
POST/v1/crm/calls/{call_sid}/link
Link a call to a person or deal
crm.calls.link_entity
EscritaIdempotenteDesde 2026-11-01
Links a call that matched nothing in the CRM to a person, a deal or both (ids of this org): stamps them on the call and creates its CRM activity, which also attaches the person's open deals and active prospects and carries the notes and disposition already saved. activity_id null means the ids were stamped but the activity could not be created. Requires full access to Phones. Module: Phones (crm_phones), even though the id starts with crm.; the credential needs the crm_phones:write scope.
Escopo
crm_phones:write
Permissão
Editar no módulo
Tool do MCP
crm_calls_link_entityNa superfície completa; na compacta, mb_execute_operation com id: "crm.calls.link_entity".
Custo declarado: até 13 leituras e 30 escritas por chamada (contam na cota diária).
Parâmetros
call_sidstringrotaobrigatório
The call: its id (Twilio's call_sid) from crm.calls.list.
