Skip to main content

​
MCP Resources

MCP Resources let agents read structured data from Alana without making explicit tool calls. Think of them as read-only data attachments that the agent can reference.

​
Available Resources

Resource URIDescription
catalog://productsPaginated product summaries for the workspace
catalog://products/{id}Full product detail by ID
catalog://categoriesCategory tree for the workspace
catalog://brandsBrand list for the workspace

​
Reading a Resource

// List available resources
const resources = await client.listResources();

// Read a specific resource
const resource = await client.readResource({
  uri: "alana://catalog/cat_abc",
});
console.log(resource.contents[0].text);

​
How Agents Use Resources

When an agent needs catalog context, it can read the resource at the start of a session rather than making repeated search_products calls. This reduces latency and tool calls for context-heavy workflows. 
Agent: "I need to review all products in the Summer 2026 catalog"
→ Reads alana://catalog/cat_summer2026
→ Has full catalog context without pagination

​
MCP Prompts

MCP Prompts are pre-built workflow templates that agents can invoke. They combine multiple tool calls into a single guided workflow.

​
Available Prompts

Prompt NameDescription
optimize-catalogRun optimization across an entire catalog
analyze-productDeep analysis of a single product
generate-feed-reportFeed performance analysis
brand-consistency-checkCheck products against brand guidelines

​
Using a Prompt

// List available prompts
const prompts = await client.listPrompts();

// Get a prompt with arguments
const prompt = await client.getPrompt({
  name: "optimize-catalog",
  arguments: { catalog_id: "cat_abc", target_platform: "google" },
});

// The prompt returns messages you can send to the LLM
console.log(prompt.messages);

​
Prompt: analyze-product

Generates a structured analysis of a product including score, improvement suggestions, and platform-specific recommendations. Arguments:
ArgumentRequiredDescription
product_idYesProduct to analyze
platformsNoComma-separated list: google,meta,openai

​
Prompt: brand-consistency-check

Checks a set of products against brand guidelines and flags inconsistencies. Arguments:
ArgumentRequiredDescription
brand_idYesBrand to check against
catalog_idNoCatalog to audit (defaults to all)
Last modified on March 18, 2026