Search attachable agent tools

agentToolReferences(input: ProjectAgentToolReferencesInput!): AgentToolReferenceSearchResult!

Requires project.agents.write.

Arguments

ArgumentTypeRequired
inputProjectAgentToolReferencesInput!Yes

Input fields

input

ProjectAgentToolReferencesInput

FieldTypeRequired
projectReferenceStringNo
sourceTargetKindStringNo
targetBranchIdIDNo
queryStringNo
names[String!]No
cursorStringNo
limitIntNo

Response

Returns AgentToolReferenceSearchResult!. Open the type for its fields and nested types.

FieldTypeDescription
data[AgentToolReference!]!Deterministically ranked and deduplicated tool references assignable to project agents. This search does not load callable tool contracts; use host tool discovery for executable tools.
pageInfoPageInfo!

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
query AgentToolReferences($input: ProjectAgentToolReferencesInput!) {
  agentToolReferences(input: $input) {
    data {
      name
      attachVia
      description
      legacyName
      source
    }
    pageInfo {
      hasNextPage
      endCursor
      hasPreviousPage
      startCursor
    }
  }
}
json
{
  "input": {
    "projectReference": "00000000-0000-4000-8000-000000000001"
  }
}