Skip to content

Agents

Agents let external tools and automations access your organization's knowledge programmatically. An Agent is an API identity — not a human member — that authenticates with an API key and is scoped to specific Audiences.

What is an Agent?

An Agent is a named credential that represents a non-human consumer of your Glossary and Playbook content. Where members sign in and learn interactively, Agents connect over an API so that tools like the Mention MCP server can query your knowledge base on behalf of your team.

Each Agent has:

  • A name and description so admins can identify what the Agent is used for
  • An API key (prefixed mk_) used to authenticate requests
  • One or more Audience grants that determine which Glossaries and Playbooks the Agent can access

Why use an Agent?

Agents are useful when you want to surface Mention's knowledge outside of the Mention app itself — for example:

  • Powering an AI assistant that answers questions using your organization's terminology and processes
  • Integrating Mention content into internal tools, chatbots, or IDE extensions via the MCP server
  • Automating workflows that need to read from a specific Audience's Glossary or Playbook

Creating an Agent

  1. Go to the Agents section in the admin sidebar.
  2. Click Create Agent.
  3. Enter a name and description.
  4. The new Agent is created and its API key is displayed once, along with a ready-to-paste MCP config snippet. Copy the key immediately — you will not be able to see the full key again.

After creation, you can grant the Agent access to one or more Audiences.

Granting Audience access

An Agent can only access content from Audiences it has been explicitly granted. To add a grant:

  1. Open the Agent's detail view.
  2. Select the Audience you want to grant access to.
  3. Confirm the grant.

You can grant access to multiple Audiences. The Agent's access to a Glossary and Playbook is determined entirely by its Audience grants — if the Agent is not granted access to an Audience, it cannot query that Audience's content.

To revoke access, remove the Audience grant from the Agent's detail view.

Rotating API keys

If an API key is compromised or you need to cycle credentials:

  1. Open the Agent's detail view.
  2. Click Rotate Key.
  3. The previous key is immediately invalidated and a new key is displayed once.

Any integration using the old key will stop working as soon as the rotation is complete. Update your external tools with the new key right away.

Deleting an Agent

Deleting an Agent removes it from your organization and automatically revokes all of its Audience grants. External tools using the Agent's key will lose access immediately.

Note that you cannot delete an Audience while it still has active Agent grants — or members, or pending invitations. Clear those first (and remove the Agent grants, or delete the Agent) before deleting the Audience.