Mentionable
Mentionable

list_projects

Tool MCP list_projects : liste tous les projets accessibles à votre API key Mentionable, avec brand, scan mode et LLMs sélectionnés. Pagination, filtre par nom, tri.

Mis à jour le 2026-04-26

list_projects

list_projects retourne tous les projets que votre API key Mentionable peut voir. C'est le point d'entrée du MCP : la plupart des autres tools attendent un projectId, donc l'agent appelle list_projects en premier pour résoudre un nom en ID. La réponse contient les données de marque, le pays cible, le mode de scan et les LLMs sélectionnés pour le tracking.

Quand l'utiliser

Appelez list_projects dès que l'agent ne connaît pas encore le projectId à utiliser. C'est aussi le bon tool pour les questions larges du type "qu'est-ce que je tracke ?", "liste mes marques", "lequel de mes projets tourne en daily ?". Combinez avec filters.nameContains pour lever l'ambiguïté quand un workspace contient plusieurs projets aux noms proches.

Paramètres

Champ Type Défaut Description
cursor string — Cursor de pagination depuis une réponse précédente.
limit integer 20 1 à 100.
filters.nameContains string — Match substring case-insensitive sur le nom du projet.
sortBy enum recent recent, oldest, alphabetical.

Réponse

Un tableau data d'objets projet plus le pageInfo standard. Chaque projet inclut les métadonnées de marque, les réglages de scan et les LLMs trackés.

{
  "data": [
    {
      "id": "clx0000aaa",
      "name": "Acme Corp",
      "url": "https://acme.com",
      "brandName": "Acme",
      "brandAliases": ["Acme Inc", "Acme Corp"],
      "contentLanguage": "en",
      "contentTargetCountry": "US",
      "scanMode": "daily",
      "selectedLlms": ["CHATGPT", "PERPLEXITY", "GEMINI"],
      "createdAt": "2026-02-10T14:23:01.000Z",
      "updatedAt": "2026-04-25T08:00:00.000Z"
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 1 }
}

Conseils et patterns

  • Appelez toujours list_projects en premier. Mettre en cache le projectId résolu côté agent évite de payer la lookup à chaque tour.
  • Utilisez filters.nameContains pour une résolution floue quand l'utilisateur cite la marque par son nom court.
  • selectedLlms indique les moteurs réellement trackés sur le projet. Évitez les filtres par LLM pour les moteurs absents de ce tableau.
  • Lisez scanMode (daily ou thrice_weekly) avant de raisonner sur la fraîcheur des lastUpdated retournés par les autres tools.

Tools liés