> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apigene.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Gateway Resources

> Available resources in the MCP Gateway

## Overview

Resources provide read-only access to information about your agent, applications, actions, contexts, and skills. MCP App UI resources expose templates for visual rendering in supported clients. They can be accessed through standard MCP resource requests.

## Static Resources (Agent Mode Only)

### Agent Instructions

**URI**: `apigene://{genai_app}/instructions`

Get the complete agent instructions including:

* Agent description and capabilities
* Internal guidelines
* Available applications list

### Available Apps List

**URI**: `apigene://{genai_app}/apps`

List all applications available in the agent:

* App names and summaries
* Action summaries (optional)
* App capabilities overview

### Contexts List

**URI**: `apigene://{genai_app}/contexts`

View all available contexts:

* Context IDs and names
* Context summaries
* Context types

### Context Type Definitions

**URI**: `apigene://{genai_app}/context-types`

Get all context type templates:

* Available context types
* How to create each type
* When to use each type

### Skills List

**URI**: `apigene://{genai_app}/skills`

List all skills available to the agent (metadata summary appropriate for discovery). For creating or updating skills, use the `add_skill` tool (see [MCP Gateway Tools](/user-guide/mcp-gateway/mcp-gateway-tools)).

## Dynamic Resource Templates

### App Actions

**URI**: `apigene://{genai_app}/apps/{app_name}/actions`

Get actions for a specific app:

* All available actions (summary or full details)
* Action descriptions
* Operation IDs

**Parameters:**

* `app_name`: The application identifier

### Action Details

**URI**: `apigene://{genai_app}/apps/{app_name}/actions/{operationId}`

Get complete schema for a specific action:

* Full parameter specifications
* Required and optional parameters
* Parameter types and descriptions

**Parameters:**

* `app_name`: The application identifier
* `operationId`: The specific action identifier

### Context Details (Agent Mode Only)

**URI**: `apigene://{genai_app}/contexts/{context_id}`

Get detailed information about a specific context:

* Full context description
* Associated apps
* Usage guidelines

**Parameters:**

* `context_id`: The context identifier

### Skill Details (Agent Mode Only)

**URI**: `apigene://{genai_app}/skills/{skill_id}`

Get skill metadata and optional packaged files (`scripts`, `references`, `assets`) when present. For the full `SKILL.md` body, use the Skill Content resource below or the `get_skill_content` tool.

**Parameters:**

* `skill_id`: The skill identifier

### Skill Content (Agent Mode Only)

**URI**: `apigene://{genai_app}/skills/{skill_id}/content`

Get the full `SKILL.md` text (front matter and Markdown) for a skill. MIME type is `text/markdown`.

**Parameters:**

* `skill_id`: The skill identifier

## MCP App UI Resources

When MCP App UI is enabled for your Apigene deployment, the gateway may expose UI resources for hosts that support embedded MCP Apps (for example Claude). These pair with the `run_action_ui` and `run_multi_actions_ui` tools.

### Run Action UI

**URI**: `ui://run-action-ui`

Template used to render a single action result inside an MCP App iframe. The host loads this resource according to the MCP Apps protocol.

### Run Multi Actions UI

**URI**: `ui://run-multi-actions-ui`

Template used to render multiple parallel action results (for example in a grid or mesh layout).

## Using Resources

Resources are accessed through standard MCP resource requests. Your MCP client will handle the protocol details automatically.

### Example: Reading Agent Instructions

```json theme={null}
{
  "method": "resources/read",
  "params": {
    "uri": "apigene://my-agent/instructions"
  }
}
```

### Example: Getting App Actions

```json theme={null}
{
  "method": "resources/read",
  "params": {
    "uri": "apigene://my-agent/apps/Slack/actions"
  }
}
```

### Example: Listing Skills (Agent Mode)

```json theme={null}
{
  "method": "resources/read",
  "params": {
    "uri": "apigene://my-agent/skills"
  }
}
```

## Resource vs Tools

**Resources** provide read-only information:

* Use when you need to read data
* Accessed via `resources/read`
* Return structured information

**Tools** execute operations:

* Use when you need to perform operations (including `run_action`, context updates, and `add_skill`)
* Accessed via `tools/call`
* Execute actions and return results

## Next Steps

* [Learn about available tools](/user-guide/mcp-gateway/mcp-gateway-tools)
* [See usage examples](/user-guide/mcp-gateway/mcp-gateway-examples)