# CiviCRM MCP by usefulapi (io.usefulapi/civicrm): tool descriptions scored

- tools/list taken: 2026-11-02 (UTC)
- From: [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/io.usefulapi%2Fcivicrm/versions/latest)
- Connected to: https://civicrm.usefulapi.io/mcp
- Homepage: https://usefulapi.io/civicrm/
- Repository: https://github.com/m190/usefulapi-mcp
- Scoring rules: v2
- Tools: 24
- Average: 50.4 / 100 (Cloudy)
- Near-identical pairs: 0

This page shows how CiviCRM MCP by usefulapi (io.usefulapi/civicrm)'s tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

## Across the server

No server-wide issues.

## Tools

- `civicrm_list_groups`: 41 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `civicrm_update_contact`: 42 / 100
  - Major: Arguments without a description: first_name, last_name, organization_name, household_name, job_title, source, preferred_language, do_not_email, do_not_phone, do_not_mail, do_not_sms.
  - Minor: The meaning of the boolean argument do_not_email is unclear.
  - Minor: The meaning of the boolean argument do_not_phone is unclear.
  - Minor: The meaning of the boolean argument do_not_mail is unclear.
  - Minor: The meaning of the boolean argument do_not_sms is unclear.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: contact_id. Name the tool or the place that returns it, or models look it up first.
- `civicrm_list_entities`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `civicrm_list_group_contacts`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `civicrm_add_contact_note`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: contact_id. Name the tool or the place that returns it, or models look it up first.
- `civicrm_list_relationships`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: contact_id. Name the tool or the place that returns it, or models look it up first.
- `civicrm_create_contact`: 48 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: job_title.
  - Minor: Says nothing about what it returns.
- `civicrm_list_activities`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `civicrm_list_cases`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `civicrm_list_contact_notes`: 49 / 100
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: contact_id. Name the tool or the place that returns it, or models look it up first.
- `civicrm_list_memberships`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `civicrm_list_participants`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `civicrm_add_contact_to_group`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: group_id, contact_id. Name the tool or the place that returns it, or models look it up first.
- `civicrm_register_participant`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: event_id, contact_id. Name the tool or the place that returns it, or models look it up first.
- `civicrm_get_contact`: 52 / 100
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: contact_id. Name the tool or the place that returns it, or models look it up first.
- `civicrm_list_contributions`: 52 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `civicrm_list_events`: 52 / 100
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `civicrm_whoami`: 52 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `civicrm_search_contacts`: 54 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
- `civicrm_create_membership`: 55 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `civicrm_log_activity`: 55 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: with_contact_ids. Name the tool or the place that returns it, or models look it up first.
- `civicrm_get_fields`: 57 / 100
  - Minor: Says nothing about what it returns.
- `civicrm_query`: 58 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: where[].field, where[].value, order_by[].field, order_by[].direction.
  - Minor: Says nothing about what it returns.
- `civicrm_record_contribution`: 65 / 100
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: contact_id. Name the tool or the place that returns it, or models look it up first.

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

[All scored servers](https://forecall.dev/en/servers)