# free_intent_signals (/docs/mcp/free-tools/free-intent-signals)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/free_intent_signals.mdx. */}

**Free intent signals by topic** · Read-only

Free on every plan of a signed-in account, also after the trial ends, no credits used. Returns up to 10 companies that have verified decision-makers in the job roles that typically buy a topic's products (e.g. sales operations and account executives for crm), each with company, domain, industry, country and up to 3 contacts (name, title, email, emailStatus). It is a role-based prospect list for the topic, not a measure of current research activity. Verified business emails are revealed, up to 10 per account per UTC day across all free tools; personal emails are never returned. emailStatus is 'verified' (address shown), 'unverified — not revealed' or 'daily free limit reached — resets 00:00 UTC' (address masked, e.g. j***@acme.example), or 'not found'. An unknown topic returns availableTopics (closest matches first); an unknown country returns 400. Free tools share a limit of 10 calls per account per UTC day (resets 00:00 UTC; past it the call returns 429).

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `topic` | `string` | Yes | Intent topic slug or name, e.g. crm, marketing-automation, cybersecurity, cloud-computing, seo. An unknown topic returns availableTopics (closest matches first). |
| `country` | `string` | No | Optional contact country: ISO code (US, GB, DE) or country name. |
| `industry` | `string` | No | Optional industry of the contact's company (partial, case-insensitive), e.g. software, financial services, SaaS / Software. |
| `limit` | `number` | No | Max companies, 1-10 (default 10). |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "free_intent_signals",
  "title": "Free intent signals by topic",
  "annotations": {
    "title": "Free intent signals by topic",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "topic": {
        "type": "string",
        "description": "Intent topic slug or name, e.g. crm, marketing-automation, cybersecurity, cloud-computing, seo. An unknown topic returns availableTopics (closest matches first)."
      },
      "country": {
        "type": "string",
        "description": "Optional contact country: ISO code (US, GB, DE) or country name."
      },
      "industry": {
        "type": "string",
        "description": "Optional industry of the contact's company (partial, case-insensitive), e.g. software, financial services, SaaS / Software."
      },
      "limit": {
        "type": "number",
        "description": "Max companies, 1-10 (default 10)."
      }
    },
    "required": [
      "topic"
    ]
  }
}
```