Overview

Resource Templates define URI patterns with dynamic parameters that are filled at runtime, enabling flexible access to resources.


Key Capabilities

  • 📋 List templates with dynamic URI patterns
  • 🔍 Search by URI pattern, name, or description
  • 📝 Dynamic parameter input
  • 🔄 Parameter substitution
  • 📜 Parameter history and persistence
  • 📄 Read resources with substituted URIs

Using Resource Templates

Step 1: Connect and Browse

  1. Navigate to 📋 Resource Templates tab
  2. Connect to server supporting templates
  3. Browse available templates

📸 Screenshot needed: resource-templates-list.png Description: Show the Resource Templates tab with multiple templates listed showing URI patterns

Step 2: Select a Template

Click a template to view its URI pattern and parameters.

Example template:

URI Pattern: file:///users/{userId}/profile.json
Parameters: userId (required)

📸 Screenshot needed: resource-templates-details.png Description: Show a selected template with URI pattern and parameter fields visible

Step 3: Fill Parameters

  1. Enter values for required parameters
  2. Values are extracted from URI pattern (e.g., {userId})
  3. Previous values are saved for quick re-use

Example:

Parameter: userId
Value: 12345
Resulting URI: file:///users/12345/profile.json

Step 4: Read Resource

Click Read Resource to fetch content using the substituted URI.

📸 Screenshot needed: resource-templates-response.png Description: Show the resource content fetched from a template with the substituted URI visible


Template Syntax

URI Patterns

Parameters are defined with curly braces:

file:///users/{userId}/profile.json
https://api.example.com/orders/{orderId}/status
db://database/records/{table}/{id}

Multiple Parameters

https://api.example.com/{version}/users/{userId}

Parameters extracted:

  • version
  • userId

Features

Parameter Persistence

Previous parameter values are saved and restored automatically.

Search & Filter

Find templates by URI pattern, name, or description.

Favorites

Mark frequently-used templates for quick access.


Common Use Cases

User Profiles

Pattern: /users/{userId}/profile
Example: /users/abc123/profile

Time-Series Data

Pattern: /logs/{date}/events.json
Example: /logs/2025-12-26/events.json

Multi-Tenant Resources

Pattern: /tenants/{tenantId}/config/{environment}
Example: /tenants/acme-corp/config/production

Troubleshooting

Parameter Not Detected

Solutions:

  • Verify parameter uses curly braces: {param}
  • Check template URI pattern is correct
  • Review server template definition

Read Fails After Substitution

Solutions:

  • Verify parameter values are correct format
  • Check resulting URI is valid
  • Test URI manually
  • Review server error messages

Next Steps