{
  "schema_version": "agentpmt.docs.v1",
  "generated_at": "2026-08-18T18:03:14.688Z",
  "release_id": "5367fe2ce2aa1968ba089b7a77934459c60b1659a1b8fa753f18f40c1cf609fa",
  "id": "69b2e500c481ec10adab7cd6",
  "page_url": "https://www.agentpmt.com/docs/core-concepts/adding-tools-to-an-agent-group",
  "markdown_url": "https://www.agentpmt.com/docs/core-concepts/adding-tools-to-an-agent-group?format=agent-md",
  "json_url": "https://www.agentpmt.com/docs/core-concepts/adding-tools-to-an-agent-group?format=agent-json",
  "source_path": "content/docs/adding-tools-to-an-agent-group.mdoc",
  "updated_at": "2026-07-23T01:20:26.647Z",
  "headings": [
    {
      "depth": 2,
      "id": "before-you-enable",
      "title": "Before You Enable"
    },
    {
      "depth": 2,
      "id": "add-a-single-tool",
      "title": "Add a Single Tool"
    },
    {
      "depth": 2,
      "id": "add-a-workflow",
      "title": "Add a Workflow"
    },
    {
      "depth": 2,
      "id": "after-you-enable",
      "title": "After You Enable"
    },
    {
      "depth": 2,
      "id": "least-privilege-credentials-and-caps",
      "title": "Least-Privilege Credentials and Caps"
    },
    {
      "depth": 2,
      "id": "workflow-dependencies",
      "title": "Workflow Dependencies"
    },
    {
      "depth": 2,
      "id": "bulk-add",
      "title": "Bulk Add"
    },
    {
      "depth": 2,
      "id": "removing-tools",
      "title": "Removing Tools"
    },
    {
      "depth": 2,
      "id": "troubleshooting",
      "title": "Troubleshooting"
    }
  ],
  "related_products": [],
  "related_workflows": [],
  "related_agents": [],
  "doc": {
    "title": "Adding Tools to an Agent Group",
    "description": "Click Enable on any tool or workflow to attach it to your AI agent's Agent Group.",
    "category": "Core Concepts",
    "image": null,
    "full_path": "core-concepts/adding-tools-to-an-agent-group",
    "body_markdown": "# Adding Tools to an Agent Group\n\nYour agent can only use tools that are in its Agent Group. Here's how to add them.\n\n## Before You Enable\n\n- Confirm the tool or workflow is needed for the agent's current job.\n- Review the input/output contract so the agent can call it with predictable fields.\n- Check whether the tool requires an external credential.\n- Set or review the Agent Group spending cap before enabling paid actions.\n- For workflows, inspect required tool dependencies before adding the workflow.\n\n---\n\n## Add a Single Tool\n\n### Find the tool\n\nBrowse the [marketplace](https://www.agentpmt.com/marketplace) or search for a specific tool.\n\n### Click Enable\n\nOn the tool's card or detail page, click the **Enable** button.\n\n### Select an Agent Group\n\nChoose which Agent Group to add the tool to. If the tool requires credentials, you'll be prompted to set them up.\n\n---\n\n## Add a Workflow\n\nWorkflows are added the same way as tools:\n\n1. Find a workflow in the marketplace\n2. Click **Enable**\n3. Select the Agent Group\n\nThe workflow's required tools are shown on its detail page. Make sure those tools are also in your Agent Group, or the workflow won't be able to execute all its steps.\n\n## After You Enable\n\n### List tools from the agent\n\nConfirm the tool or workflow appears in the connected agent's catalog.\n\n### Run a small verification call\n\nUse known inputs and confirm the result, status, and credit usage are expected.\n\n### Review Agent Activity\n\nCheck Control Center for the request, selected credential, status, and execution metadata.\n\n## Least-Privilege Credentials and Caps\n\nUse credentials that expose only the external account access the tool needs. Keep caps low when introducing a new tool, then raise them only after you have reviewed normal call volume and activity records.\n\n## Workflow Dependencies\n\nIf a workflow depends on tools that are not enabled for the group, the agent may discover the workflow but fail during execution. Enable each dependency deliberately, connect the required credentials, and test the workflow end to end.\n\n---\n\n## Bulk Add\n\nFrom the **Control Center → Agent Groups** subtab, you can bulk-add multiple tools at once:\n\n1. Open your Agent Group settings\n2. Click **Bulk Add**\n3. Select the tools you want\n4. Confirm\n\n---\n\n## Removing Tools\n\nFrom your Agent Group settings, you can remove individual tools or workflows at any time. Removing a tool immediately prevents your agent from using it.\n\nBefore removing a tool, check whether any enabled workflows depend on it. If removal breaks a workflow, either disable the workflow too or replace the dependency and run another verification call. Re-enable the prior tool if rollback is needed.\n\n## Troubleshooting\n\n| Symptom | Check |\n| --- | --- |\n| Tool does not appear in the agent | Confirm it is enabled on the same Agent Group used by the connection. |\n| Tool asks for credentials | Connect the required credential to the group and retry discovery. |\n| Workflow fails mid-run | Enable the missing dependency tool and verify its credential. |\n| Call is rejected for spend | Review the Agent Group cap, available credits, and the tool's expected cost. |\n### [Browse the Marketplace](https://www.agentpmt.com/docs/core-concepts/browsing-the-marketplace)\n\nFind tools to add\n\n### [API To MCP Tool Conversion](https://www.agentpmt.com/docs/agent-connections/api-to-mcp-tool-conversion)\n\nCreate a private API Access tool and authorize it for an Agent Group\n\n### [How Credentials Work](https://www.agentpmt.com/docs/core-concepts/how-credentials-work)\n\nSet up credentials if a tool requires them\n"
  }
}
