Skip to main content
Retrieve agent capabilities and metadata.

​
Request

GET /.well-known/agent-card.json 
curl https://agent-{gateway-id}.noorle.com/.well-known/agent-card.json \
  -H "Authorization: Bearer eyJhbGc..."

​
Response

{
  "name": "My AI Agent",
  "description": "Helpful AI agent for data processing",
  "version": "1.0.0",
  "capabilities": [
    "tool1_operation1",
    "tool2_operation2",
    "web_search_query"
  ],
  "models": ["gpt-4", "claude-3-opus"],
  "maxTokens": 4096,
  "skills": [
    {
      "name": "data_analysis",
      "description": "Analyze data and extract insights"
    }
  ]
}

​
Response Fields

FieldTypeDescription
namestringAgent name
descriptionstringWhat agent does
versionstringAgent version
capabilitiesarrayAvailable tool names
modelsarrayAvailable LLM models
maxTokensintegerMax context length
skillsarrayHigh-level agent skills

​
Usage

const response = await fetch(
  `https://agent-{gateway-id}.noorle.com/.well-known/agent-card.json`,
  {
    headers: { "Authorization": `Bearer ${token}` }
  }
);
const card = await response.json();
console.log(`Agent: ${card.name}`);
console.log(`Capabilities: ${card.capabilities.join(", ")}`);