opencode-agora 0.3.0 → 0.4.0

package/dist/data.js

@@ -1,4 +1,4 @@
-export const dataRefreshedAt = '2026-05-14';
+export const dataRefreshedAt = '2026-05-15';
 export const samplePackages = [
     // ── Filesystem & Core I/O ──
     {
@@ -130,6 +130,60 @@ export const samplePackages = [
         createdAt: '2025-03-28'
     },
     // ── AI & Memory ──
+    {
+        id: 'mcp-openai',
+        name: 'openai-mcp-server',
+        description: 'OpenAI API — GPT completions, embeddings, assistants, and file management',
+        author: 'openai',
+        version: '1.3.0',
+        category: 'mcp',
+        tags: ['openai', 'ai', 'llm', 'api', 'completions'],
+        stars: 12350,
+        installs: 345890,
+        repository: 'https://github.com/openai/openai-mcp-server',
+        npmPackage: 'openai-mcp-server',
+        createdAt: '2025-01-15'
+    },
+    {
+        id: 'mcp-anthropic',
+        name: '@anthropic/mcp-server',
+        description: 'Anthropic Claude API — completions, messages, and tool use integration',
+        author: 'Anthropic, PBC',
+        version: '0.4.1',
+        category: 'mcp',
+        tags: ['anthropic', 'claude', 'ai', 'llm', 'api'],
+        stars: 5678,
+        installs: 289000,
+        repository: 'https://github.com/anthropics/anthropic-mcp-server',
+        createdAt: '2025-04-01'
+    },
+    {
+        id: 'mcp-replicate',
+        name: 'replicate-mcp-server',
+        description: 'Run ML models via Replicate API — image generation, LLMs, audio, and video',
+        author: 'Replicate',
+        version: '0.3.0',
+        category: 'mcp',
+        tags: ['replicate', 'ai', 'ml', 'models', 'api'],
+        stars: 1234,
+        installs: 34560,
+        repository: 'https://github.com/replicate/replicate-mcp-server',
+        npmPackage: 'replicate-mcp',
+        createdAt: '2025-02-10'
+    },
+    {
+        id: 'mcp-huggingface',
+        name: 'hf-mcp-server',
+        description: 'Hugging Face inference API — text generation, embeddings, and model discovery',
+        author: 'huggingface',
+        version: '0.5.0',
+        category: 'mcp',
+        tags: ['huggingface', 'ai', 'transformers', 'api'],
+        stars: 2340,
+        installs: 56780,
+        repository: 'https://github.com/huggingface/hf-mcp-server',
+        createdAt: '2025-03-05'
+    },
     {
         id: 'mcp-sequential-thinking',
         name: '@modelcontextprotocol/server-sequential-thinking',
@@ -313,7 +367,174 @@ export const samplePackages = [
         npmPackage: '@browsermcp/mcp',
         createdAt: '2025-04-05'
     },
-    // ── Communication & Productivity ──
+    // ── Project Management ──
+    {
+        id: 'mcp-linear',
+        name: '@linear/mcp-server',
+        description: 'Linear issue tracking — create and update issues, search projects, manage sprints',
+        author: 'Linear',
+        version: '1.1.0',
+        category: 'mcp',
+        tags: ['linear', 'project-management', 'issues', 'sprints'],
+        stars: 6543,
+        installs: 189000,
+        repository: 'https://github.com/linear/linear-mcp-server',
+        createdAt: '2025-02-25'
+    },
+    {
+        id: 'mcp-jira',
+        name: 'jira-mcp-server',
+        description: 'Jira and Confluence — issue creation, search, project management, and wiki access',
+        author: 'atlassian-labs',
+        version: '0.9.0',
+        category: 'mcp',
+        tags: ['jira', 'confluence', 'atlassian', 'project-management'],
+        stars: 3200,
+        installs: 98700,
+        repository: 'https://github.com/atlassian-labs/jira-mcp-server',
+        npmPackage: 'jira-mcp-server',
+        createdAt: '2025-03-01'
+    },
+    {
+        id: 'mcp-asana',
+        name: 'asana-mcp-server',
+        description: 'Asana task and project management — tasks, projects, teams, and portfolio views',
+        author: 'asana-community',
+        version: '0.4.0',
+        category: 'mcp',
+        tags: ['asana', 'project-management', 'tasks'],
+        stars: 450,
+        installs: 12300,
+        repository: 'https://github.com/asana-community/asana-mcp-server',
+        createdAt: '2025-04-10'
+    },
+    // ── Knowledge & Notes ──
+    {
+        id: 'mcp-obsidian',
+        name: 'obsidian-mcp-server',
+        description: 'Obsidian vault access — read, search, and create notes across your knowledge base',
+        author: 'obsidian-mcp',
+        version: '1.5.0',
+        category: 'mcp',
+        tags: ['obsidian', 'notes', 'knowledge', 'markdown'],
+        stars: 9800,
+        installs: 345000,
+        repository: 'https://github.com/obsidian-mcp/obsidian-mcp-server',
+        npmPackage: 'obsidian-mcp-server',
+        createdAt: '2025-01-25'
+    },
+    {
+        id: 'mcp-confluence',
+        name: 'confluence-mcp-server',
+        description: 'Confluence wiki — pages, search, spaces, and content management for documentation',
+        author: 'atlassian-labs',
+        version: '0.3.0',
+        category: 'mcp',
+        tags: ['confluence', 'wiki', 'documentation', 'knowledge'],
+        stars: 890,
+        installs: 23400,
+        repository: 'https://github.com/atlassian-labs/confluence-mcp-server',
+        npmPackage: 'confluence-mcp-server',
+        createdAt: '2025-04-05'
+    },
+    // ── Development Tools ──
+    {
+        id: 'mcp-sonarqube',
+        name: '@sonarsource/mcp-server-sonarqube',
+        description: 'SonarQube code quality — issues, metrics, quality gates, and project analysis',
+        author: 'SonarSource',
+        version: '0.5.0',
+        category: 'mcp',
+        tags: ['sonarqube', 'code-quality', 'linting', 'static-analysis'],
+        stars: 560,
+        installs: 18900,
+        repository: 'https://github.com/SonarSource/sonarqube-mcp-server',
+        createdAt: '2025-03-20'
+    },
+    {
+        id: 'mcp-snyk',
+        name: 'snyk-mcp-server',
+        description: 'Snyk vulnerability scanning — dependency checks, container scanning, and IaC analysis',
+        author: 'snyk-labs',
+        version: '0.3.0',
+        category: 'mcp',
+        tags: ['snyk', 'security', 'vulnerability', 'dependencies'],
+        stars: 780,
+        installs: 34500,
+        repository: 'https://github.com/snyk-labs/snyk-mcp-server',
+        createdAt: '2025-04-15'
+    },
+    // ── Cloud Platforms ──
+    {
+        id: 'mcp-aws',
+        name: '@aws/mcp-server-aws',
+        description: 'AWS cloud management — EC2, S3, Lambda, IAM, and cost management across services',
+        author: 'Amazon Web Services',
+        version: '0.6.0',
+        category: 'mcp',
+        tags: ['aws', 'cloud', 'ec2', 's3', 'lambda', 'infrastructure'],
+        stars: 4500,
+        installs: 156000,
+        repository: 'https://github.com/awslabs/aws-mcp-server',
+        createdAt: '2025-02-01'
+    },
+    {
+        id: 'mcp-vercel',
+        name: '@vercel/mcp-server',
+        description: 'Vercel deployment management — projects, deployments, domains, and environment variables',
+        author: 'Vercel',
+        version: '0.4.0',
+        category: 'mcp',
+        tags: ['vercel', 'deployment', 'frontend', 'hosting'],
+        stars: 3400,
+        installs: 89000,
+        repository: 'https://github.com/vercel/vercel-mcp-server',
+        createdAt: '2025-03-01'
+    },
+    {
+        id: 'mcp-netlify',
+        name: '@netlify/mcp-server',
+        description: 'Netlify deployment management — sites, deploys, functions, and environment config',
+        author: 'Netlify',
+        version: '0.3.0',
+        category: 'mcp',
+        tags: ['netlify', 'deployment', 'hosting', 'jamstack'],
+        stars: 890,
+        installs: 23400,
+        repository: 'https://github.com/netlify/netlify-mcp-server',
+        npmPackage: '@netlify/mcp',
+        createdAt: '2025-04-01'
+    },
+    // ── Communication & Community ──
+    {
+        id: 'mcp-discord',
+        name: 'discord-mcp-server',
+        description: 'Discord integration — messages, channels, server management, and webhook control',
+        author: 'discord-community',
+        version: '0.6.0',
+        category: 'mcp',
+        tags: ['discord', 'chat', 'community', 'messaging'],
+        stars: 3456,
+        installs: 98700,
+        repository: 'https://github.com/discord-community/discord-mcp-server',
+        npmPackage: 'discord-mcp-server',
+        createdAt: '2025-03-05'
+    },
+    {
+        id: 'mcp-email',
+        name: '@sendgrid/mcp-server',
+        description: 'Email delivery via SendGrid — send transactional emails, manage templates, and analytics',
+        author: 'sendgrid-community',
+        version: '0.3.0',
+        category: 'mcp',
+        tags: ['email', 'sendgrid', 'communication', 'notifications'],
+        stars: 450,
+        installs: 23400,
+        repository: 'https://github.com/sendgrid-community/sendgrid-mcp-server',
+        npmPackage: 'sendgrid-mcp',
+        createdAt: '2025-04-15'
+    },
+    // ── Productivity & Office ──
     {
         id: 'mcp-slack',
         name: '@modelcontextprotocol/server-slack',
@@ -385,6 +606,90 @@ export const samplePackages = [
         npmPackage: '@21st-dev/magic',
         createdAt: '2025-03-11'
     },
+    // ── Containers & Virtualisation ──
+    {
+        id: 'mcp-docker',
+        name: 'mcp-docker-server',
+        description: 'Docker container management — images, containers, compose, logs, and exec',
+        author: 'docker-labs',
+        version: '1.2.0',
+        category: 'mcp',
+        tags: ['docker', 'containers', 'devops', 'infrastructure'],
+        stars: 8456,
+        installs: 234500,
+        repository: 'https://github.com/docker-labs/mcp-docker-server',
+        npmPackage: 'mcp-docker-server',
+        createdAt: '2025-01-20'
+    },
+    {
+        id: 'mcp-sqlite',
+        name: '@sqlite/mcp-server',
+        description: 'SQLite database management — queries, schema inspection, and data migration',
+        author: 'sqlite-community',
+        version: '0.8.2',
+        category: 'mcp',
+        tags: ['sqlite', 'database', 'sql', 'data'],
+        stars: 3200,
+        installs: 128000,
+        repository: 'https://github.com/sqlite-community/sqlite-mcp',
+        npmPackage: '@easy-mcps/sqlite-mcp-server',
+        createdAt: '2025-02-15'
+    },
+    {
+        id: 'mcp-pinecone',
+        name: 'pinecone-mcp-server',
+        description: 'Pinecone vector database — index management, upsert, query, and namespace ops',
+        author: 'pinecone-io',
+        version: '0.4.0',
+        category: 'mcp',
+        tags: ['pinecone', 'vector', 'database', 'ai', 'embeddings'],
+        stars: 890,
+        installs: 23450,
+        repository: 'https://github.com/pinecone-io/pinecone-mcp-server',
+        npmPackage: 'pinecone-mcp',
+        createdAt: '2025-03-10'
+    },
+    {
+        id: 'mcp-qdrant',
+        name: 'qdrant-mcp-server',
+        description: 'Qdrant vector search — collection management, point operations, and filtering',
+        author: 'qdrant',
+        version: '0.6.0',
+        category: 'mcp',
+        tags: ['qdrant', 'vector', 'database', 'search', 'ai'],
+        stars: 670,
+        installs: 18900,
+        repository: 'https://github.com/qdrant/qdrant-mcp-server',
+        npmPackage: 'qdrant-mcp-server',
+        createdAt: '2025-03-15'
+    },
+    {
+        id: 'mcp-chromadb',
+        name: 'chromadb-mcp-server',
+        description: 'ChromaDB vector store — collections, document embeddings, and similarity search',
+        author: 'chroma-core',
+        version: '0.3.1',
+        category: 'mcp',
+        tags: ['chromadb', 'vector', 'database', 'embeddings', 'ai'],
+        stars: 1560,
+        installs: 45600,
+        repository: 'https://github.com/chroma-core/chromadb-mcp-server',
+        npmPackage: 'chromadb-mcp',
+        createdAt: '2025-04-01'
+    },
+    {
+        id: 'mcp-neo4j',
+        name: 'neo4j-mcp-server',
+        description: 'Neo4j graph database — Cypher queries, schema management, and graph analytics',
+        author: 'neo4j',
+        version: '0.5.0',
+        category: 'mcp',
+        tags: ['neo4j', 'graph', 'database', 'cypher'],
+        stars: 2100,
+        installs: 56700,
+        repository: 'https://github.com/neo4j/neo4j-mcp-server',
+        createdAt: '2025-02-20'
+    },
     // ── Cloud, Infra & DevOps ──
     {
         id: 'mcp-cloudflare',
@@ -455,7 +760,61 @@ export const samplePackages = [
         npmPackage: 'mcp-remote',
         createdAt: '2025-03-17'
     },
-    // ── Monitoring & Payments ──
+    // ── Monitoring & Observability ──
+    {
+        id: 'mcp-datadog',
+        name: '@datadog/mcp-server',
+        description: 'Datadog monitoring — dashboards, monitors, logs, traces, and incident management',
+        author: 'DataDog',
+        version: '0.5.0',
+        category: 'mcp',
+        tags: ['datadog', 'monitoring', 'observability', 'apm'],
+        stars: 1200,
+        installs: 45600,
+        repository: 'https://github.com/DataDog/datadog-mcp-server',
+        npmPackage: 'datadog-mcp',
+        createdAt: '2025-03-10'
+    },
+    {
+        id: 'mcp-grafana',
+        name: 'grafana-mcp-server',
+        description: 'Grafana dashboards — query metrics, manage alerts, and explore observability data',
+        author: 'grafana-community',
+        version: '0.4.0',
+        category: 'mcp',
+        tags: ['grafana', 'monitoring', 'dashboards', 'observability'],
+        stars: 2340,
+        installs: 67800,
+        repository: 'https://github.com/grafana-community/grafana-mcp-server',
+        createdAt: '2025-02-20'
+    },
+    {
+        id: 'mcp-pagerduty',
+        name: 'pagerduty-mcp-server',
+        description: 'PagerDuty incident management — incidents, on-call schedules, and escalation policies',
+        author: 'PagerDuty',
+        version: '0.3.5',
+        category: 'mcp',
+        tags: ['pagerduty', 'incidents', 'on-call', 'alerting'],
+        stars: 560,
+        installs: 18900,
+        repository: 'https://github.com/PagerDuty/pagerduty-mcp-server',
+        createdAt: '2025-04-01'
+    },
+    {
+        id: 'mcp-newrelic',
+        name: '@newrelic/mcp-server',
+        description: 'New Relic observability — APM, infrastructure, logs, and query NRQL across services',
+        author: 'New Relic',
+        version: '0.3.0',
+        category: 'mcp',
+        tags: ['newrelic', 'apm', 'observability', 'monitoring'],
+        stars: 340,
+        installs: 12300,
+        repository: 'https://github.com/newrelic/newrelic-mcp-server',
+        createdAt: '2025-04-10'
+    },
+    // ── Payments & Commerce ──
     {
         id: 'mcp-sentry',
         name: '@sentry/mcp-server',
@@ -484,6 +843,19 @@ export const samplePackages = [
         npmPackage: '@stripe/mcp',
         createdAt: '2025-02-19'
     },
+    {
+        id: 'mcp-sequelize',
+        name: '@anthropic/mcp-server-sequelize',
+        description: 'Sequelize ORM integration — model management, migrations, query inspection',
+        author: 'Anthropic, PBC',
+        version: '0.1.0',
+        category: 'mcp',
+        tags: ['database', 'sequelize', 'orm', 'sql'],
+        stars: 2840,
+        installs: 12400,
+        repository: 'https://github.com/modelcontextprotocol/servers',
+        createdAt: '2025-03-10'
+    },
     // ── Prompts ──
     {
         id: 'prompt-code-review',
@@ -520,6 +892,42 @@ export const samplePackages = [
         stars: 780,
         installs: 4500,
         createdAt: '2025-03-01'
+    },
+    {
+        id: 'prompt-debug-session',
+        name: 'Structured Debugging',
+        description: 'Systematic root-cause analysis — form hypotheses, gather evidence, identify the bug',
+        author: 'agora-community',
+        version: '1.0.0',
+        category: 'prompt',
+        tags: ['debug', 'root-cause', 'analysis', 'troubleshooting'],
+        stars: 920,
+        installs: 6200,
+        createdAt: '2025-04-10'
+    },
+    {
+        id: 'prompt-test-strategy',
+        name: 'Test Strategy Planner',
+        description: 'Design a comprehensive testing strategy covering unit, integration, e2e, and property-based tests',
+        author: 'agora-community',
+        version: '1.0.0',
+        category: 'prompt',
+        tags: ['testing', 'strategy', 'quality', 'coverage'],
+        stars: 410,
+        installs: 2100,
+        createdAt: '2025-04-20'
+    },
+    {
+        id: 'prompt-migration-plan',
+        name: 'Migration Plan Generator',
+        description: 'Plan safe, phased migrations — framework upgrades, database migrations, cloud provider moves',
+        author: 'agora-community',
+        version: '1.0.0',
+        category: 'prompt',
+        tags: ['migration', 'planning', 'safety', 'rollback'],
+        stars: 340,
+        installs: 1800,
+        createdAt: '2025-05-01'
     }
 ];
 export const sampleWorkflows = [
@@ -640,6 +1048,46 @@ Provide a score (1-10) for each dimension with actionable improvements.`,
         forks: 42,
         createdAt: '2025-03-10'
     },
+    {
+        id: 'wf-doc-generator',
+        name: 'Documentation Generator',
+        description: 'Generate comprehensive documentation for codebases — API docs, README, and inline comments',
+        author: 'doc-master',
+        prompt: `Generate thorough documentation for the codebase:
+1. Create or update README with setup, usage, and architecture
+2. Document all public APIs with parameter descriptions
+3. Add inline code comments for complex logic
+4. Generate API reference docs from TypeScript types
+5. Create changelog from git history
+6. Add contributing guide
+7. Document environment variables and configuration
+
+Focus on clarity and completeness. The docs should help new contributors onboard quickly.`,
+        tags: ['documentation', 'readme', 'api-docs', 'onboarding'],
+        stars: 245,
+        forks: 38,
+        createdAt: '2025-04-05'
+    },
+    {
+        id: 'wf-postmortem',
+        name: 'Incident Post-Mortem',
+        description: 'Structured incident analysis — timeline, root cause, impact, and action items',
+        author: 'sre-team',
+        prompt: `Conduct a blameless post-mortem analysis:
+1. Establish incident timeline from logs and metrics
+2. Identify root cause and contributing factors
+3. Document impact (users affected, downtime duration, data loss)
+4. Analyze detection and response time
+5. Identify systemic issues beyond the immediate cause
+6. Propose specific action items with owners
+7. Define monitoring to detect recurrence
+
+The goal is learning, not blame. Every action item should be specific and testable.`,
+        tags: ['postmortem', 'incident', 'sre', 'analysis'],
+        stars: 189,
+        forks: 45,
+        createdAt: '2025-04-20'
+    },
     {
         id: 'wf-dependency-audit',
         name: 'Dependency Audit',
@@ -884,6 +1332,82 @@ npx tsx src/my-server.ts
             }
         ]
     },
+    {
+        id: 'tut-docker-dev',
+        title: 'Docker Development with MCP',
+        description: 'Manage Docker containers, images, and compose files from your AI assistant',
+        level: 'intermediate',
+        duration: '20 min',
+        steps: [
+            {
+                title: 'Install the Docker MCP Server',
+                content: 'First, install the Docker MCP server globally. This lets your AI assistant manage containers.',
+                code: `npm install -g mcp-docker-server`
+            },
+            {
+                title: 'Configure in OpenCode',
+                content: 'Add the Docker MCP server to your opencode.json:',
+                code: `{
+  "mcp": {
+    "docker": {
+      "type": "local",
+      "command": ["npx", "mcp-docker-server"]
+    }
+  }
+}`
+            },
+            {
+                title: 'Common Docker Tasks',
+                content: 'Now you can ask your AI to: list running containers, view logs, restart services, build images, manage Docker Compose, and clean up unused resources — all from your terminal via natural language.'
+            }
+        ]
+    },
+    {
+        id: 'tut-api-testing',
+        title: 'API Testing with MCP Tools',
+        description: 'Learn to test and debug APIs using MCP servers and OpenCode workflows',
+        level: 'beginner',
+        duration: '15 min',
+        steps: [
+            {
+                title: 'Set Up API Testing Tools',
+                content: 'Install the necessary MCP servers for API testing. The Brave Search and GitHub servers are useful for testing external APIs.',
+                code: `agora install mcp-github`
+            },
+            {
+                title: 'Test REST Endpoints',
+                content: 'With the MCP tools configured, you can ask OpenCode to test API endpoints: "Make a GET request to https://api.example.com/health" or "Test the POST /users endpoint with this payload."'
+            },
+            {
+                title: 'Automate API Tests',
+                content: 'Use the TDD workflow combined with API tools to write automated tests: "Create a test suite that verifies all API endpoints return correct status codes and response shapes."'
+            }
+        ]
+    },
+    {
+        id: 'tut-vector-search',
+        title: 'Vector Search with MCP',
+        description: 'Set up and query vector databases for semantic search and RAG applications',
+        level: 'advanced',
+        duration: '30 min',
+        steps: [
+            {
+                title: 'Choose a Vector Database',
+                content: 'Agora supports several vector databases. For local development, ChromaDB is the easiest to start with. For production, Pinecone or Qdrant are recommended.',
+                code: `agora search vector
+agora browse mcp-chromadb`
+            },
+            {
+                title: 'Install and Configure',
+                content: 'Install your chosen vector database MCP server and add it to OpenCode:',
+                code: `npm install -g chromadb-mcp-server`
+            },
+            {
+                title: 'Semantic Search in Action',
+                content: 'With vector search configured, you can ask OpenCode to: "Search for documents similar to this text" or "Find the most relevant code examples for implementing OAuth." The AI will use the vector database to find semantically similar content.'
+            }
+        ]
+    },
     {
         id: 'tut-opencode-tips',
         title: 'OpenCode Power User Tips',
@@ -905,6 +1429,146 @@ npx tsx src/my-server.ts
                 content: 'Continue previous sessions with `opencode -c`, fork them with `opencode --fork`, or start a specific agent with `opencode --agent reviewer`. Sessions persist across restarts.'
             }
         ]
+    },
+    {
+        id: 'tut-agora-auth',
+        title: 'Agora Auth & Login',
+        description: 'Authenticate with the Agora API using the device-code login flow',
+        level: 'beginner',
+        duration: '10 min',
+        steps: [
+            {
+                title: 'Why Authenticate?',
+                content: 'Some Agora features require authentication: publishing packages, posting discussions, submitting reviews, and viewing community profiles. The device-code flow lets you log in via your browser without exposing tokens.'
+            },
+            {
+                title: 'Device-Code Login',
+                content: 'Run `agora auth login --api-url <your-api-url>`. This opens a browser where you authorize via GitHub. The CLI polls for the token and stores it locally. No token ever appears in your terminal history.',
+                code: `agora auth login --api-url https://api.agora.example.com`
+            },
+            {
+                title: 'Check Your Status',
+                content: 'Use `agora auth status` to see if you are logged in. The token is displayed masked (e.g. "ghp_...cdef"). Use `agora auth logout` to clear stored credentials.',
+                code: `agora auth status --json`
+            },
+            {
+                title: 'Headless / CI Login',
+                content: 'For automation, pass a token directly via --token or the AGORA_TOKEN environment variable. This skips the browser flow and stores the credential immediately.',
+                code: `agora auth login --token $AGORA_TOKEN --api-url https://api.agora.example.com`
+            }
+        ]
+    },
+    {
+        id: 'tut-catalog-contrib',
+        title: 'Contributing to the Catalog',
+        description: 'Add MCP servers, workflows, and tutorials to the Agora ecosystem',
+        level: 'intermediate',
+        duration: '20 min',
+        steps: [
+            {
+                title: 'The Offline Catalog',
+                content: 'Agora ships with a bundled offline catalog in src/data.ts. It contains MCP servers, prompt tools, workflows, and tutorials. The catalog is refreshed periodically and serves as the default data source when no API is available.'
+            },
+            {
+                title: 'Add an MCP Server',
+                content: 'To add a new MCP server, append an entry to the samplePackages array in src/data.ts. Include the id, name, npm package, description, tags, and metadata. Run the tests to verify your entry works.',
+                code: `{
+  id: 'mcp-my-server',
+  name: '@you/mcp-server',
+  description: 'Description of what it does',
+  author: 'You',
+  version: '1.0.0',
+  category: 'mcp',
+  tags: ['your-tag', 'tool'],
+  stars: 100,
+  installs: 500,
+  npmPackage: '@you/mcp-server',
+  createdAt: '2026-05-15'
+}`
+            },
+            {
+                title: 'Add a Workflow',
+                content: 'Workflows are structured prompts that guide AI behavior. Add them to the sampleWorkflows array with a descriptive prompt that includes step-by-step instructions, tags, and metadata.',
+                code: `{
+  id: 'wf-my-workflow',
+  name: 'My Workflow Name',
+  description: 'What this workflow does',
+  author: 'you',
+  prompt: 'Step-by-step instructions for the AI to follow...',
+  tags: ['your-tag'],
+  stars: 1,
+  forks: 0,
+  createdAt: '2026-05-15'
+}`
+            },
+            {
+                title: 'Add a Tutorial',
+                content: 'Tutorials guide users through multi-step learning paths. Add them to the sampleTutorials array with a unique id, title, level, duration, and an array of steps. Each step has a title and content, with optional code blocks.',
+                code: `{
+  id: 'tut-my-topic',
+  title: 'My Tutorial',
+  description: 'What users will learn',
+  level: 'beginner',
+  duration: '15 min',
+  steps: [
+    { title: 'First Step', content: 'Explanation...' },
+    { title: 'Second Step', content: 'More details...', code: 'example command' }
+  ]
+}`
+            },
+            {
+                title: 'Submit a Pull Request',
+                content: 'After adding your entries to data.ts, run the tests with \`bun test\`, build with \`npm run build\`, and submit a PR on GitHub. See CONTRIBUTING.md for the full contribution guide.'
+            }
+        ]
+    },
+    {
+        id: 'tut-deploy-backend',
+        title: 'Deploy the Agora Backend',
+        description: 'Self-host the Agora API on Cloudflare Workers with D1',
+        level: 'advanced',
+        duration: '30 min',
+        steps: [
+            {
+                title: 'Prerequisites',
+                content: 'To deploy the backend you need: a Cloudflare account, the Wrangler CLI installed, and Node.js 18+. The backend is a Cloudflare Workers app using Hono and D1 (Cloudflare\'s serverless SQLite).'
+            },
+            {
+                title: 'Set Up D1 Database',
+                content: 'Create a D1 database and apply the schema. Note the database ID for the wrangler.toml configuration.',
+                code: `wrangler login
+wrangler d1 create agora
+wrangler d1 execute agora --file=backend/schema.sql`
+            },
+            {
+                title: 'Configure Secrets',
+                content: 'Set the required secrets for GitHub OAuth and JWT signing. Create a GitHub OAuth App first at https://github.com/settings/developers.',
+                code: `wrangler secret put GITHUB_CLIENT_ID
+wrangler secret put GITHUB_CLIENT_SECRET
+wrangler secret put AUTH_SECRET`
+            },
+            {
+                title: 'Update wrangler.toml',
+                content: 'Edit backend/wrangler.toml with your D1 database ID from step 2. The binding name must stay as "DB" to match the TypeScript bindings.',
+                code: `[[d1_databases]]
+binding = "DB"
+database_name = "agora"
+database_id = "<your-database-id-here>"`
+            },
+            {
+                title: 'Deploy',
+                content: 'Run the deploy command from the backend directory. After deployment, use the API URL with your CLI: `agora auth login --api-url https://your-worker.example.com`',
+                code: `cd backend
+npm run deploy`
+            },
+            {
+                title: 'Local Development with Docker',
+                content: 'For local development without deploying, use Docker Compose. It runs wrangler with a local D1 SQLite database so you can iterate on the API without a Cloudflare account.',
+                code: `docker compose up --build
+# API available at http://localhost:8787
+curl http://localhost:8787/health`
+            }
+        ]
     }
 ];
 export const trendingTags = [