Skip to main content
Glama

Get Contacts Run

get-contacts-run
Read-onlyIdempotent

Read live companies, validated contacts and finish totals. Progress events (20, page with events_after) come with the first company page only. Omit run_id to list 20 recent runs; page with before.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get-contacts-run"
  }
}

Input Schema

NameRequiredDescriptionDefault
beforeNo
fieldsNo
run_idNo
contextNoWhy you are calling this tool, in a few words. No names or emails.
llm_modelNoYour model id, or "unknown".
rows_limitNo
rows_offsetNo
events_afterNo
conversation_idNoThe conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics.

Output Schema

NameRequiredDescriptionDefault
kindNo
runsNo
errorNo
stepsNo
eventsNo
run_idNo
statusNo
summaryNo
progressNo
companiesNo
created_atNo
expires_atNo
generationNo
updated_atNo
next_cursorNo
current_stepNo
contacts_totalNo
companies_totalNo
_mcp_instructionsNoServer-issued metadata for this conversation.
applied_company_filtersNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • addedInput schema / properties / conversation_id
      Added value: +{
      +  "description": "The conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics.",
      +  "type": "string"
      +}
    • changedInput schema / properties / rows_limit / default
      Previous value: -50New value: +10
    • removedOutput schema / additionalProperties
      Removed value: -true
    • addedOutput schema / properties
      Added value: +{
      +  "_mcp_instructions": {
      +    "description": "Server-issued metadata for this conversation.",
      +    "properties": {
      +      "conversation_id": {
      +        "description": "The server-issued conversation identifier.",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "applied_company_filters": {
      +    "anyOf": [
      +      {
      +        "properties": {
      +          "employee_range": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "filter_country": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "filter_industry": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "filter_state": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "negate_filter_country": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "negate_filter_industry": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "negate_filter_state": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "revenue_range": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "sub_industry": {
      +            "anyOf": [
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [],
      +        "type": "object"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "companies": {
      +    "items": {
      +      "properties": {
      +        "company": {
      +          "additionalProperties": true,
      +          "required": [],
      +          "type": "object"
      +        },
      +        "contacts": {
      +          "items": {
      +            "properties": {
      +              "company_score": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "debug_only": {
      +                "anyOf": [
      +                  {
      +                    "type": "boolean"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "department": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "domain": {
      +                "type": "string"
      +              },
      +              "email": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "email_state": {
      +                "anyOf": [
      +                  {
      +                    "enum": [
      +                      "checking",
      +                      "queued",
      +                      "skipped"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "email_status": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "fit_label": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "floor": {
      +                "type": "boolean"
      +              },
      +              "linkedin_url": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "name": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "not_fit": {
      +                "type": "boolean"
      +              },
      +              "p_fit": {
      +                "anyOf": [
      +                  {
      +                    "type": "number"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "persona_id": {
      +                "anyOf": [
      +                  {
      +                    "type": "integer"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "reason": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "row_key": {
      +                "type": "string"
      +              },
      +              "seniority": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "title": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              }
      +            },
      +            "required": [],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "domain": {
      +          "type": "string"
      +        },
      +        "linkedin_contacts": {
      +          "type": "integer"
      +        },
      +        "mailboxes_checked": {
      +          "type": "integer"
      +        },
      +        "people_reviewed": {
      +          "type": "integer"
      +        },
      +        "status": {
      +          "enum": [
      +            "pending",
      +            "finding_people",
      +            "finding_emails",
      +            "validated",
      +            "skipped",
      +            "cancelled",
      +            "failed"
      +          ],
      +          "type": "string"
      +        },
      +        "validated_contacts": {
      +          "type": "integer"
      +        }
      +      },
      +      "required": [],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  "companies_total": {
      +    "type": "integer"
      +  },
      +  "contacts_total": {
      +    "type": "integer"
      +  },
      +  "created_at": {
      +    "format": "date-time",
      +    "type": "string"
      +  },
      +  "current_step": {
      +    "anyOf": [
      +      {
      +        "enum": [
      +          "find_contacts",
      +          "find_missing",
      +          "find_emails",
      +          "discover",
      +          "validate"
      +        ],
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "error": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "events": {
      +    "items": {
      +      "properties": {
      +        "company_name": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "created_at": {
      +          "format": "date-time",
      +          "type": "string"
      +        },
      +        "domain": {
      +          "type": "string"
      +        },
      +        "kind": {
      +          "enum": [
      +            "progress",
      +            "company_skipped"
      +          ],
      +          "type": "string"
      +        },
      +        "mailboxes_checked": {
      +          "type": "integer"
      +        },
      +        "people_reviewed": {
      +          "type": "integer"
      +        },
      +        "seq": {
      +          "type": "integer"
      +        },
      +        "status": {
      +          "type": "string"
      +        },
      +        "titles_considered": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "validated_titles": {
      +          "items": {
      +            "properties": {
      +              "status": {
      +                "enum": [
      +                  "Validated",
      +                  "Validated (catch-all resolved)"
      +                ],
      +                "type": "string"
      +              },
      +              "title": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              }
      +            },
      +            "required": [],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        }
      +      },
      +      "required": [],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  "expires_at": {
      +    "format": "date-time",
      +    "type": "string"
      +  },
      +  "generation": {
      +    "type": "integer"
      +  },
      +  "kind": {
      +    "type": "string"
      +  },
      +  "next_cursor": {
      +    "type": "integer"
      +  },
      +  "progress": {
      +    "properties": {
      +      "checking_companies": {
      +        "type": "integer"
      +      },
      +      "companies_delivered": {
      +        "type": "integer"
      +      },
      +      "companies_done": {
      +        "type": "integer"
      +      },
      +      "companies_known": {
      +        "type": "integer"
      +      },
      +      "linkedin_contacts": {
      +        "type": "integer"
      +      },
      +      "people_reviewed": {
      +        "type": "integer"
      +      },
      +      "validated_contacts": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [],
      +    "type": "object"
      +  },
      +  "run_id": {
      +    "type": "string"
      +  },
      +  "runs": {
      +    "items": {
      +      "properties": {
      +        "applied_company_filters": {
      +          "anyOf": [
      +            {
      +              "properties": {
      +                "employee_range": {
      +                  "anyOf": [
      +                    {
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "filter_country": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "filter_industry": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "filter_state": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "negate_filter_country": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "negate_filter_industry": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "negate_filter_state": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "revenue_range": {
      +                  "anyOf": [
      +                    {
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "sub_industry": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                }
      +              },
      +              "required": [],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "companies": {
      +          "items": {
      +            "properties": {
      +              "company": {
      +                "additionalProperties": true,
      +                "required": [],
      +                "type": "object"
      +              },
      +              "contacts": {
      +                "items": {
      +                  "properties": {
      +                    "company_score": {
      +                      "anyOf": [
      +                        {
      +                          "type": "number"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "debug_only": {
      +                      "anyOf": [
      +                        {
      +                          "type": "boolean"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "department": {
      +                      "anyOf": [
      +                        {
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "domain": {
      +                      "type": "string"
      +                    },
      +                    "email": {
      +                      "anyOf": [
      +                        {
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "email_state": {
      +                      "anyOf": [
      +                        {
      +                          "enum": [
      +                            "checking",
      +                            "queued",
      +                            "skipped"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "email_status": {
      +                      "anyOf": [
      +                        {
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "fit_label": {
      +                      "anyOf": [
      +                        {
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "floor": {
      +                      "type": "boolean"
      +                    },
      +                    "linkedin_url": {
      +                      "anyOf": [
      +                        {
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "name": {
      +                      "anyOf": [
      +                        {
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "not_fit": {
      +                      "type": "boolean"
      +                    },
      +                    "p_fit": {
      +                      "anyOf": [
      +                        {
      +                          "type": "number"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "persona_id": {
      +                      "anyOf": [
      +                        {
      +                          "type": "integer"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "reason": {
      +                      "anyOf": [
      +                        {
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "row_key": {
      +                      "type": "string"
      +                    },
      +                    "seniority": {
      +                      "anyOf": [
      +                        {
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "title": {
      +                      "anyOf": [
      +                        {
      +                          "type": "string"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    }
      +                  },
      +                  "required": [],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "domain": {
      +                "type": "string"
      +              },
      +              "linkedin_contacts": {
      +                "type": "integer"
      +              },
      +              "mailboxes_checked": {
      +                "type": "integer"
      +              },
      +              "people_reviewed": {
      +                "type": "integer"
      +              },
      +              "status": {
      +                "enum": [
      +                  "pending",
      +                  "finding_people",
      +                  "finding_emails",
      +                  "validated",
      +                  "skipped",
      +                  "cancelled",
      +                  "failed"
      +                ],
      +                "type": "string"
      +              },
      +              "validated_contacts": {
      +                "type": "integer"
      +              }
      +            },
      +            "required": [],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "companies_total": {
      +          "type": "integer"
      +        },
      +        "contacts_total": {
      +          "type": "integer"
      +        },
      +        "created_at": {
      +          "format": "date-time",
      +          "type": "string"
      +        },
      +        "current_step": {
      +          "anyOf": [
      +            {
      +              "enum": [
      +                "find_contacts",
      +                "find_missing",
      +                "find_emails",
      +                "discover",
      +                "validate"
      +              ],
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "error": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "expires_at": {
      +          "format": "date-time",
      +          "type": "string"
      +        },
      +        "generation": {
      +          "type": "integer"
      +        },
      +        "kind": {
      +          "type": "string"
      +        },
      +        "progress": {
      +          "properties": {
      +            "checking_companies": {
      +              "type": "integer"
      +            },
      +            "companies_delivered": {
      +              "type": "integer"
      +            },
      +            "companies_done": {
      +              "type": "integer"
      +            },
      +            "companies_known": {
      +              "type": "integer"
      +            },
      +            "linkedin_contacts": {
      +              "type": "integer"
      +            },
      +            "people_reviewed": {
      +              "type": "integer"
      +            },
      +            "validated_contacts": {
      +              "type": "integer"
      +            }
      +          },
      +          "required": [],
      +          "type": "object"
      +        },
      +        "run_id": {
      +          "type": "string"
      +        },
      +        "status": {
      +          "type": "string"
      +        },
      +        "steps": {
      +          "additionalProperties": {
      +            "properties": {
      +              "counts": {
      +                "additionalProperties": {
      +                  "type": "integer"
      +                },
      +                "required": [],
      +                "type": "object"
      +              },
      +              "error": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "status": {
      +                "enum": [
      +                  "pending",
      +                  "running",
      +                  "done",
      +                  "failed",
      +                  "skipped",
      +                  "cancelled"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [],
      +            "type": "object"
      +          },
      +          "propertyNames": {
      +            "enum": [
      +              "find_contacts",
      +              "find_missing",
      +              "find_emails",
      +              "discover",
      +              "validate"
      +            ],
      +            "type": "string"
      +          },
      +          "required": [],
      +          "type": "object"
      +        },
      +        "summary": {
      +          "anyOf": [
      +            {
      +              "properties": {
      +                "companies_delivered": {
      +                  "type": "integer"
      +                },
      +                "linkedin_contacts": {
      +                  "type": "integer"
      +                },
      +                "skipped_no_mx": {
      +                  "anyOf": [
      +                    {
      +                      "type": "integer"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "stop_reason": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "low_delivery_yield",
      +                        "source_exhausted"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "validated_contacts": {
      +                  "type": "integer"
      +                }
      +              },
      +              "required": [],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "updated_at": {
      +          "format": "date-time",
      +          "type": "string"
      +        }
      +      },
      +      "required": [],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  "status": {
      +    "type": "string"
      +  },
      +  "steps": {
      +    "additionalProperties": {
      +      "properties": {
      +        "counts": {
      +          "additionalProperties": {
      +            "type": "integer"
      +          },
      +          "required": [],
      +          "type": "object"
      +        },
      +        "error": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "status": {
      +          "enum": [
      +            "pending",
      +            "running",
      +            "done",
      +            "failed",
      +            "skipped",
      +            "cancelled"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [],
      +      "type": "object"
      +    },
      +    "propertyNames": {
      +      "enum": [
      +        "find_contacts",
      +        "find_missing",
      +        "find_emails",
      +        "discover",
      +        "validate"
      +      ],
      +      "type": "string"
      +    },
      +    "required": [],
      +    "type": "object"
      +  },
      +  "summary": {
      +    "anyOf": [
      +      {
      +        "properties": {
      +          "companies_delivered": {
      +            "type": "integer"
      +          },
      +          "linkedin_contacts": {
      +            "type": "integer"
      +          },
      +          "skipped_no_mx": {
      +            "anyOf": [
      +              {
      +                "type": "integer"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "stop_reason": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "low_delivery_yield",
      +                  "source_exhausted"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "validated_contacts": {
      +            "type": "integer"
      +          }
      +        },
      +        "required": [],
      +        "type": "object"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "updated_at": {
      +    "format": "date-time",
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / required
      Added value: +[]
  2. Changed2 schema fields changed
    • addedInput schema / properties / context
      Added value: +{
      +  "description": "Why you are calling this tool, in a few words. No names or emails.",
      +  "type": "string"
      +}
    • addedInput schema / properties / llm_model
      Added value: +{
      +  "description": "Your model id, or \"unknown\".",
      +  "type": "string"
      +}
  3. First observed

TDQS

A3.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), so the description earns credit for adding behavior the annotations cannot express: progress events come only with the first company page, event pages are 20 events, and the run list is capped at 20 with cursor paging via before. These are non-obvious constraints that change how an agent paginates. It does not disclose anything about the interaction between events_after and rows_offset paging.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences, front-loaded with what is returned, and nothing is padding. The telegraphic grammar ('Progress events (20, page with events_after)', 'finish totals') is compact but occasionally cryptic, costing a bit of first-read clarity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The existence of an output schema means return values needn't be explained, and mode selection plus event paging are covered. Against a 9-parameter tool with no required parameters, though, it omits the meaning of fields, rows_limit, rows_offset and how the two independent paging mechanisms (rows_offset vs. events_after) relate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is low (33%), so the description must carry weight; it explains run_id (omit to list runs), before (paging cursor), and events_after (event paging), which is real added meaning. But fields, rows_limit, and rows_offset are undocumented in both schema and description, and the default semantics of before as a date-time cursor are not clarified.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a concrete verb ('Read') and enumerates the returned resources: live companies, validated contacts, finish totals. It also distinguishes two operating modes (run results vs. listing recent runs when run_id is omitted), so an agent can tell it apart from cancel-contacts-run without opening the schema. It stops short of a single clean statement like 'retrieve results of a contacts enrichment run', leaving the resource slightly implicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit conditional guidance for the two modes ('Omit run_id to list 20 recent runs') and for paging ('page with before'), which is useful. However, it never says when to prefer this over siblings such as find-contacts or account-status, and no exclusions or prerequisites are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources