Your findings.
Your assistant.

Get connected

You’ll need an IntentHound project, access as its owner, and an MCP client that accepts a Bearer token or custom HTTP headers.

1. Open your project, then go to Settings > MCP.
2. Create a named token for your client. Leave Allow lead status updates off for read-only access.
3. Copy the token while it is displayed. It expires after 90 days, and you can revoke it from the same screen.
4. Add the server URL below to your client using Streamable HTTP. Send your token in the Authorization header as Bearer YOUR_MCP_TOKEN.

The token grants access to one project. Create another token to connect a different client or project. Keep tokens in your client’s local settings or secret store.

Client configuration

Cursor

Add this entry to your personal mcp.json, replacing the placeholder with your token. Use personal settings to keep the token out of shared project files. See the Cursor MCP documentation.

{
  "mcpServers": {
    "intenthound": {
      "url": "https://app.getintenthound.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

VS Code

Use an HTTP server entry in your personal MCP configuration. The password input keeps the token out of the configuration file. See the VS Code MCP documentation.

{
  "inputs": [{
    "type": "promptString",
    "id": "intenthound-token",
    "description": "IntentHound MCP token",
    "password": true
  }],
  "servers": {
    "intenthound": {
      "type": "http",
      "url": "https://app.getintenthound.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:intenthound-token}"
      }
    }
  }
}

Other clients can use the same endpoint if they support authenticated Streamable HTTP. This connection uses project tokens; clients that require an OAuth sign-in flow need a different authentication option.

What your assistant can use

These tools use data already saved in IntentHound. They do not start new scans. Findings filters match the dashboard’s Findings view; analytics follows the Analytics tab and includes all saved findings in its time window.

Start with a useful question.

“Show me this project’s new findings from the last seven days with an intent score of at least 80. Include the original links.”

“Compare the sources that produced findings this month. Which ones deserve a closer look?”

“Read this finding and our brand guidelines. Help me draft a useful answer I can review.”

“Mark finding 123 as contacted.”

The last example needs a token with lead status updates enabled. Your assistant should treat post text as third-party content and use the original link when reviewing a lead.

Access stays in your hands.

Only project owners can create or revoke MCP tokens. Stored credentials contain a hash of the token. The full token is shown at creation and cannot be retrieved later.