{
  "name": "authentication-guide",
  "uri": "file://docs/auth-guide.md",
  "title": "Authentication Guide",
  "description": "Step-by-step authentication instructions - read before making authenticated requests",
  "mime_type": "text/markdown",
  "content": "## Authentication\n\n### Getting a Token\n1. Call POST /auth/login with email and password\n2. Store the `access_token` from response\n3. Include in all requests: `Authorization: Bearer {token}`\n\n### Token Refresh\nTokens expire after 1 hour. Call POST /auth/refresh with your `refresh_token`.\n\n### Common Errors\n- 401: Token expired or invalid\n- 403: Insufficient permissions"
}

{
  "name": "business-rules",
  "uri": "file://docs/business-rules.md",
  "title": "Business Rules & Constraints",
  "description": "Important business rules to consider before creating or modifying data",
  "mime_type": "text/markdown",
  "content": "## Order Rules\n\n- Orders over $1000 require manager approval\n- Maximum 50 items per order\n- Discount codes limited to one per order\n\n## User Rules\n\n- Users must verify email before checkout\n- Admin role required for refunds > $500\n- Account lockout after 5 failed login attempts"
}

{
  "name": "format-response",
  "title": "Standard Response Format",
  "description": "Use this to format all user-facing responses consistently",
  "arguments": [
    {"name": "status", "required": true, "description": "success or error"},
    {"name": "message", "required": true, "description": "Main message"},
    {"name": "details", "required": false, "description": "Additional details"}
  ],
  "template": "{{#if status eq 'success'}}✅{{else}}❌{{/if}} **{{status | uppercase}}**\n\n{{message}}\n\n{{#if details}}📋 Details: {{details}}{{/if}}"
}

{
  "name": "create-user-workflow",
  "title": "Create User Workflow",
  "description": "Follow these steps when creating a new user account",
  "arguments": [
    {"name": "email", "required": true, "description": "New user's email"},
    {"name": "name", "required": true, "description": "User's full name"},
    {"name": "role", "required": false, "description": "Role (default: member)"}
  ],
  "template": "## Creating User: {{name}} ({{email}})\n\n**Step 1:** Validate email\n```\nPOST /users/validate-email\n{\"email\": \"{{email}}\"}\n```\n\n**Step 2:** Create user (if validation passes)\n```\nPOST /users\n{\"email\": \"{{email}}\", \"name\": \"{{name}}\", \"role\": \"{{role}}\"}\n```\n\n**Step 3:** Send welcome email\n```\nPOST /users/\{id\}/send-welcome\n```\n\n**Step 4:** Return user ID and confirmation to user"
}

{
  "name": "explain-error",
  "title": "Explain API Error",
  "description": "Translate API error codes into user-friendly explanations",
  "arguments": [
    {"name": "code", "required": true, "description": "Error code from API"},
    {"name": "context", "required": false, "description": "What the user was trying to do"}
  ],
  "template": "The API returned error code **{{code}}**.\n\n{{#if context}}You were trying to: {{context}}\n\n{{/if}}Please look up this error code in the error-codes resource and explain:\n1. What went wrong\n2. Why it happened\n3. How to fix it\n4. Whether to retry or take different action"
}

{
  "name": "webhook-config-schema",
  "uri": "file://schemas/webhook-config.json",
  "title": "Webhook Configuration Schema",
  "description": "Valid options for webhook configuration - reference when creating/updating webhooks",
  "mime_type": "application/json",
  "content": "{\n  \"type\": \"object\",\n  \"required\": [\"url\", \"events\"],\n  \"properties\": {\n    \"url\": {\"type\": \"string\", \"format\": \"uri\"},\n    \"events\": {\"type\": \"array\", \"items\": {\"enum\": [\"order.created\", \"order.updated\", \"user.created\"]}},\n    \"secret\": {\"type\": \"string\", \"minLength\": 32},\n    \"enabled\": {\"type\": \"boolean\", \"default\": true}\n  }\n}"
}

{
  "name": "smart-error-handler",
  "title": "Smart Error Handler",
  "description": "Handle errors with full context",
  "arguments": [
    {"name": "error_code", "required": true},
    {"name": "operation", "required": true}
  ],
  "template": "Error {{error_code}} occurred during {{operation}}.\n\n1. Look up {{error_code}} in the 'error-codes' resource\n2. Check 'business-rules' resource for any relevant constraints\n3. Provide user-friendly explanation and suggested action"
}

{
  "name": "environment-config",
  "uri": "file://config/production.md",
  "title": "Production Environment",
  "description": "Current environment settings and limits",
  "content": "## Production Environment\n\n- **Rate Limit:** 1000 req/min\n- **Timeout:** 30 seconds\n- **Max Payload:** 10MB\n- **Support:** support@company.com"
}

{
  "name": "validate-before-create",
  "title": "Pre-Creation Validation",
  "description": "Run these checks before creating expensive resources",
  "arguments": [
    {"name": "resource_type", "required": true},
    {"name": "data", "required": true}
  ],
  "template": "Before creating {{resource_type}}:\n\n1. Check 'business-rules' resource for constraints\n2. Validate {{data}} against schema in 'schemas' resources\n3. Verify user has permission (check 'permissions' resource)\n4. Estimate cost if applicable\n5. Only proceed if all checks pass"
}