@atray/mcp 1.0.0

package/README.md

@@ -0,0 +1,90 @@
+# ATRAY MCP
+
+[![npm version](https://img.shields.io/npm/v/@atray/mcp.svg)](https://www.npmjs.com/package/@atray/mcp)
+
+MCP (Model Context Protocol) server for the [ATRAY](https://atray.app) API. Lets an AI
+assistant (Claude, Claude Code, Cursor, and any other MCP client) manage your ATRAY
+campaigns, posts, and brand profile in natural language.
+
+> ATRAY is a SaaS that creates Instagram content with AI: you describe your brand, the AI
+> generates posts (image, caption, hashtags), and ATRAY schedules and publishes them for you.
+
+## Requirements
+
+- Node.js >= 18
+- An ATRAY account and an **API key**. Generate one in the Studio under
+  **Settings → API keys** (`https://studio.atray.app`). The key (`atray_...`) is shown only
+  once on creation, so store it safely.
+
+## Quick start
+
+### Claude Code (CLI), one command
+
+```bash
+claude mcp add atray -e ATRAY_API_KEY=atray_your_key -- npx -y @atray/mcp
+```
+
+### Manual config (Claude Desktop, Cursor, and others)
+
+Add this to your client's MCP config (in Claude Desktop, `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "atray": {
+      "command": "npx",
+      "args": ["-y", "@atray/mcp"],
+      "env": { "ATRAY_API_KEY": "atray_your_key" }
+    }
+  }
+}
+```
+
+Restart the client and the ATRAY tools become available.
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `ATRAY_API_KEY` | yes | - | Your ATRAY API key (`atray_...`). |
+| `ATRAY_API_URL` | no | `https://api.atray.app` | Override the API base URL (for self-hosted / staging). |
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `getBrandProfile` / `updateBrandProfile` | View and update the brand profile. |
+| `listCampaigns` / `createCampaign` / `getCampaign` / `updateCampaign` | Manage campaigns. `createCampaign` generates posts with AI (1 content credit per post). |
+| `listCampaignPosts` | List posts of a campaign. |
+| `listPosts` / `createPost` / `getPost` / `updatePost` | Manage posts (text and carousel). |
+| `regeneratePostText` / `regeneratePostImage` | Regenerate caption or image with AI. |
+| `uploadPostVideo` | Upload a video (mp4/mov/webm, up to 120 MB) as the post media; published to Instagram as a Reel. |
+| `listApiKeys` / `createApiKey` / `updateApiKey` / `revokeApiKey` | Manage your API keys. |
+
+Each AI-generated post consumes 1 content credit from your plan. Creating a campaign
+requires a completed brand profile.
+
+## API reference
+
+Full interactive REST reference (Swagger): <https://api.atray.app/docs/>
+
+## Local development
+
+```bash
+git clone https://github.com/atray-app/mcp.git
+cd mcp
+npm install
+ATRAY_API_KEY=atray_your_key npm start
+```
+
+The server speaks MCP over stdio.
+
+## Links
+
+- Website: <https://atray.app>
+- Documentation: <https://atray.app/docs.html>
+- Issues: <https://github.com/atray-app/mcp/issues>
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@atray/mcp",
+  "version": "1.0.0",
+  "description": "MCP server for ATRAY API - manage campaigns, posts and brand profile via AI",
+  "type": "module",
+  "bin": {
+    "atray-mcp": "./src/index.js"
+  },
+  "files": [
+    "src/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "start": "node src/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": ["mcp", "atray", "ai", "instagram", "content", "social-media", "automation"],
+  "license": "MIT",
+  "author": {
+    "name": "ATRAY",
+    "email": "contato@atray.app",
+    "url": "https://atray.app"
+  },
+  "homepage": "https://atray.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/atray-app/mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/atray-app/mcp/issues",
+    "email": "contato@atray.app"
+  }
+}

package/src/api.js

@@ -0,0 +1,93 @@
+/**
+ * Thin HTTP client for the ATRAY API.
+ * All requests are authenticated via the ATRAY_API_KEY environment variable.
+ */
+
+const BASE_URL = (process.env.ATRAY_API_URL || 'https://api.atray.app').replace(/\/$/, '');
+const API_KEY  = process.env.ATRAY_API_KEY || '';
+
+if (!API_KEY) {
+  process.stderr.write('[atray-mcp] WARNING: ATRAY_API_KEY not set\n');
+}
+
+/**
+ * @param {string} method  - HTTP method (GET, POST, PUT, PATCH, DELETE)
+ * @param {string} path    - API path, e.g. '/campaigns'
+ * @param {object} [body]  - Request body (JSON)
+ * @param {object} [query] - Query string params
+ */
+async function request(method, path, { body, query } = {}) {
+  let url = BASE_URL + path;
+
+  if (query) {
+    const params = Object.entries(query)
+      .filter(([, v]) => v !== undefined && v !== null && v !== '')
+      .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`);
+    if (params.length) url += '?' + params.join('&');
+  }
+
+  const headers = {
+    'Authorization': `Bearer ${API_KEY}`,
+    'Content-Type': 'application/json',
+    'Accept': 'application/json',
+  };
+
+  const res = await fetch(url, {
+    method,
+    headers,
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  });
+
+  return parseResponse(res);
+}
+
+/**
+ * Multipart/form-data upload (e.g. post video). The Content-Type header
+ * (with boundary) is set automatically by fetch from the FormData body.
+ * @param {string} path        - API path, e.g. '/posts/<id>/video'
+ * @param {object} opts
+ * @param {string} opts.field       - Form field name, e.g. 'video'
+ * @param {Buffer} opts.buffer      - File contents
+ * @param {string} opts.filename    - Original file name (extension matters)
+ * @param {string} opts.contentType - File MIME type
+ */
+async function upload(path, { field, buffer, filename, contentType }) {
+  const form = new FormData();
+  form.append(field, new Blob([buffer], { type: contentType }), filename);
+
+  const res = await fetch(BASE_URL + path, {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${API_KEY}`,
+      'Accept': 'application/json',
+    },
+    body: form,
+  });
+
+  return parseResponse(res);
+}
+
+async function parseResponse(res) {
+  const text = await res.text();
+  let data;
+  try { data = JSON.parse(text); } catch { data = { raw: text }; }
+
+  if (!res.ok) {
+    const msg = data?.error || data?.message || `HTTP ${res.status}`;
+    const err = new Error(`ATRAY API error ${res.status}: ${msg}`);
+    err.status = res.status;
+    err.data   = data;
+    throw err;
+  }
+
+  return data;
+}
+
+export const api = {
+  get:    (path, query)       => request('GET',    path, { query }),
+  post:   (path, body, query) => request('POST',   path, { body, query }),
+  put:    (path, body)        => request('PUT',    path, { body }),
+  patch:  (path, body)        => request('PATCH',  path, { body }),
+  delete: (path)              => request('DELETE', path),
+  upload,
+};

package/src/index.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { tools } from './tools.js';
+import { api } from './api.js';
+
+const server = new Server(
+  { name: 'atray-mcp', version: '1.0.0' },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args = {} } = request.params;
+  try {
+    const result = await callTool(name, args);
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+  }
+});
+
+async function callTool(name, a) {
+  switch (name) {
+    // ─── BRAND ──────────────────────────────────────────────────────────────
+    case 'getBrandProfile':
+      return api.get('/brand/profile');
+
+    case 'updateBrandProfile':
+      return api.put('/brand/profile', a);
+
+    // ─── CAMPAIGNS ──────────────────────────────────────────────────────────
+    case 'listCampaigns':
+      return api.get('/campaigns', a);
+
+    case 'createCampaign':
+      return api.post('/campaigns', a);
+
+    case 'getCampaign': {
+      const { id, ...q } = a;
+      return api.get(`/campaigns/${id}`, q);
+    }
+
+    case 'updateCampaign': {
+      const { id, ...body } = a;
+      return api.patch(`/campaigns/${id}`, body);
+    }
+
+    case 'listCampaignPosts': {
+      const { id, ...q } = a;
+      return api.get(`/campaigns/${id}/posts`, q);
+    }
+
+    // ─── POSTS ──────────────────────────────────────────────────────────────
+    case 'listPosts':
+      return api.get('/posts', a);
+
+    case 'createPost':
+      return api.post('/posts', a);
+
+    case 'getPost':
+      return api.get(`/posts/${a.id}`);
+
+    case 'updatePost': {
+      const { id, ...body } = a;
+      return api.patch(`/posts/${id}`, body);
+    }
+
+    case 'regeneratePostText':
+      return api.post(`/posts/${a.id}/regenerate-text`);
+
+    case 'regeneratePostImage': {
+      const { id, ...body } = a;
+      return api.post(`/posts/${id}/regenerate-image`, body);
+    }
+
+    case 'uploadPostVideo':
+      return uploadPostVideo(a);
+
+    // ─── API KEYS ────────────────────────────────────────────────────────────
+    case 'listApiKeys':
+      return api.get('/api-keys');
+
+    case 'createApiKey':
+      return api.post('/api-keys', a);
+
+    case 'updateApiKey': {
+      const { id, ...body } = a;
+      return api.patch(`/api-keys/${id}`, body);
+    }
+
+    case 'revokeApiKey':
+      return api.delete(`/api-keys/${a.id}`);
+
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}
+
+const VIDEO_MIME = { mp4: 'video/mp4', mov: 'video/quicktime', webm: 'video/webm' };
+const VIDEO_MAX_BYTES = 120 * 1024 * 1024;
+
+/** Sobe um vídeo (arquivo local ou URL) como mídia do post. Publicado no Instagram vira Reel. */
+async function uploadPostVideo({ id, file_path, video_url }) {
+  if (!id) throw new Error('id (post UUID) is required');
+  if (!file_path && !video_url) throw new Error('Provide file_path (local file) or video_url (public URL)');
+
+  let buffer;
+  let filename;
+  if (file_path) {
+    buffer = await readFile(file_path);
+    filename = basename(file_path);
+  } else {
+    const res = await fetch(video_url);
+    if (!res.ok) throw new Error(`Failed to download video_url: HTTP ${res.status}`);
+    buffer = Buffer.from(await res.arrayBuffer());
+    filename = basename(new URL(video_url).pathname) || 'video.mp4';
+    if (!/\.(mp4|mov|webm)$/i.test(filename)) {
+      const ct = (res.headers.get('content-type') || '').toLowerCase();
+      const ext = Object.keys(VIDEO_MIME).find((k) => VIDEO_MIME[k] === ct.split(';')[0].trim());
+      if (ext) filename = 'video.' + ext;
+    }
+  }
+
+  const m = filename.toLowerCase().match(/\.(mp4|mov|webm)$/);
+  if (!m) throw new Error('Video must be .mp4, .mov or .webm');
+  if (buffer.length > VIDEO_MAX_BYTES) throw new Error('Video exceeds the 120 MB limit');
+
+  return api.upload(`/posts/${id}/video`, {
+    field: 'video',
+    buffer,
+    filename,
+    contentType: VIDEO_MIME[m[1]],
+  });
+}
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/tools.js

@@ -0,0 +1,289 @@
+/**
+ * MCP tool definitions for the ATRAY API.
+ * Each tool maps directly to an x-mcp-enabled endpoint in openapi.yaml.
+ *
+ * Schema convention:
+ *   inputSchema follows JSON Schema (Draft 7) - the MCP SDK validates inputs before calling handler.
+ *   All IDs are UUID strings. All dates are ISO-8601.
+ */
+
+export const tools = [
+  // ─── BRAND ────────────────────────────────────────────────────────────────
+
+  {
+    name: 'getBrandProfile',
+    description: "Returns the authenticated user's brand profile: name, description, target audience, tone of voice and CTA default.",
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+
+  {
+    name: 'updateBrandProfile',
+    description: "Updates the brand profile. Only send the fields you want to change.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name:            { type: 'string', description: 'Brand/company name' },
+        description:     { type: 'string', description: 'Business description' },
+        target_audience: { type: 'string', description: 'Target audience' },
+        tone:            { type: 'string', enum: ['professional', 'friendly', 'direct', 'premium'], description: 'Tone of voice' },
+        cta_default:     { type: 'string', description: 'Default call-to-action text for posts' },
+      },
+    },
+  },
+
+  // ─── CAMPAIGNS ────────────────────────────────────────────────────────────
+
+  {
+    name: 'listCampaigns',
+    description: 'Lists the user\'s campaigns with optional filters. Returns items array and total count.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        status: { type: 'string', enum: ['active', 'generating', 'archived'], description: 'Filter by status' },
+        q:      { type: 'string', description: 'Search by name or theme' },
+        sort:   { type: 'string', enum: ['name', 'theme', 'created_at', 'status', 'posts_count'], description: 'Sort field (default: created_at)' },
+        order:  { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction (default: desc)' },
+        limit:  { type: 'integer', minimum: 1, maximum: 100, description: 'Results per page (default: 20)' },
+        offset: { type: 'integer', minimum: 0, description: 'Pagination offset (default: 0)' },
+      },
+    },
+  },
+
+  {
+    name: 'createCampaign',
+    description: 'Creates a new campaign and automatically generates posts via AI (1 credit per post). Requires a completed brand profile. Returns the created campaign.',
+    inputSchema: {
+      type: 'object',
+      required: ['name'],
+      properties: {
+        name:         { type: 'string', maxLength: 255, description: 'Campaign name (required)' },
+        objective:    { type: 'string', enum: ['awareness', 'engagement', 'sales', 'traffic', 'leads'], description: 'Campaign objective' },
+        theme:        { type: 'string', description: 'Central theme or subject of the campaign' },
+        context_text: { type: 'string', description: 'Context or brief for AI content generation (min 20 chars)' },
+        start_date:   { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+        end_date:     { type: 'string', description: 'End date (YYYY-MM-DD)' },
+        frequency:    { type: 'integer', description: 'Posts per week' },
+        post_time:    { type: 'string', description: 'Preferred publish time (HH:MM)' },
+        cta_text:     { type: 'string', description: 'Call-to-action text' },
+        cta_link:     { type: 'string', description: 'Call-to-action URL' },
+        hashtags:     { type: 'array', items: { type: 'string' }, description: 'Hashtags (without #)' },
+      },
+    },
+  },
+
+  {
+    name: 'getCampaign',
+    description: 'Returns a single campaign by ID.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id: { type: 'string', description: 'Campaign UUID' },
+      },
+    },
+  },
+
+  {
+    name: 'updateCampaign',
+    description: 'Updates a campaign. Only send the fields you want to change.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id:           { type: 'string', description: 'Campaign UUID' },
+        name:         { type: 'string', maxLength: 255 },
+        status:       { type: 'string', enum: ['active', 'generating', 'archived'] },
+        objective:    { type: 'string', enum: ['awareness', 'engagement', 'sales', 'traffic', 'leads'] },
+        theme:        { type: 'string' },
+        context_text: { type: 'string', description: 'Min 20 chars' },
+        start_date:   { type: 'string', description: 'YYYY-MM-DD' },
+        end_date:     { type: 'string', description: 'YYYY-MM-DD' },
+        frequency:    { type: 'integer' },
+        post_time:    { type: 'string', description: 'HH:MM' },
+        cta_text:     { type: 'string' },
+        cta_link:     { type: 'string' },
+      },
+    },
+  },
+
+  {
+    name: 'listCampaignPosts',
+    description: 'Lists all posts belonging to a specific campaign with optional filters.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id:     { type: 'string', description: 'Campaign UUID' },
+        status: { type: 'string', enum: ['draft', 'scheduled', 'published'], description: 'Filter by post status' },
+        sort:   { type: 'string', enum: ['scheduled_at', 'created_at', 'status'], description: 'Sort field (default: scheduled_at)' },
+        order:  { type: 'string', enum: ['asc', 'desc'] },
+        limit:  { type: 'integer', minimum: 1, maximum: 100, description: 'Default: 20' },
+        offset: { type: 'integer', minimum: 0, description: 'Default: 0' },
+      },
+    },
+  },
+
+  // ─── POSTS ────────────────────────────────────────────────────────────────
+
+  {
+    name: 'listPosts',
+    description: 'Lists posts with optional filters. Use campaign_id to filter by campaign, or the string "null" to list standalone posts (not linked to any campaign). Without campaign_id returns all posts.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        campaign_id: { type: 'string', description: 'Campaign UUID to filter, or the literal string "null" for standalone posts' },
+        status:      { type: 'string', enum: ['draft', 'scheduled', 'published'] },
+        sort:        { type: 'string', enum: ['scheduled_at', 'created_at', 'status'], description: 'Default: scheduled_at' },
+        order:       { type: 'string', enum: ['asc', 'desc'] },
+        limit:       { type: 'integer', minimum: 1, maximum: 100, description: 'Default: 20' },
+        offset:      { type: 'integer', minimum: 0, description: 'Default: 0' },
+      },
+    },
+  },
+
+  {
+    name: 'createPost',
+    description: 'Creates a standalone post draft. Use type="carousel" with image_descriptions[] (3-6 items) for a carousel post. Default type="text" uses image_description for a single image.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        campaign_id:        { type: 'string', description: 'Campaign UUID to link to (optional)' },
+        type:               { type: 'string', enum: ['text', 'carousel'], description: 'Post type (default: text)' },
+        caption_text:       { type: 'string', description: 'Post caption text' },
+        cta:                { type: 'string', description: 'Call-to-action text (e.g. "Link in bio")' },
+        hashtags:           { type: 'array', items: { type: 'string' }, description: 'Hashtags (without #)' },
+        image_description:  { type: 'string', description: 'Image description for single-image posts (type=text)' },
+        image_descriptions: { type: 'array', items: { type: 'string' }, description: 'Image description per slide for carousel posts (type=carousel, 3-6 items)' },
+        context:            { type: 'string', description: 'Context/brief for AI text generation (required for standalone posts)' },
+        image_text_enabled: { type: 'boolean', description: 'Include text overlay in generated image (default: true)' },
+        image_logo_enabled: { type: 'boolean', description: 'Include brand logo in generated image (default: true)' },
+      },
+    },
+  },
+
+  {
+    name: 'getPost',
+    description: 'Returns a single post by ID, including media history and scheduling info.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id: { type: 'string', description: 'Post UUID' },
+      },
+    },
+  },
+
+  {
+    name: 'updatePost',
+    description: 'Updates a post. Only send the fields you want to change. Supports updating caption, CTA, hashtags, image description, context and image generation settings.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id:                 { type: 'string', description: 'Post UUID' },
+        caption_text:       { type: 'string' },
+        cta:                { type: 'string' },
+        hashtags:           { type: 'array', items: { type: 'string' } },
+        image_description:  { type: 'string', description: 'Image description for single-image posts' },
+        image_descriptions: { type: 'array', items: { type: 'string' }, description: 'Image descriptions per slide for carousel posts (3-6 items)' },
+        context:            { type: 'string', description: 'Context/brief for AI text generation' },
+        status:             { type: 'string', enum: ['draft', 'scheduled', 'published'] },
+        scheduled_at:       { type: 'string', description: 'Publish datetime (ISO-8601, must be in the future)' },
+        image_text_enabled: { type: 'boolean' },
+        image_logo_enabled: { type: 'boolean' },
+      },
+    },
+  },
+
+  {
+    name: 'regeneratePostText',
+    description: 'Regenerates the post caption and hashtags using AI. For standalone posts (no campaign), context must be filled in the post.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id: { type: 'string', description: 'Post UUID' },
+      },
+    },
+  },
+
+  {
+    name: 'regeneratePostImage',
+    description: 'Generates a new image for the post using AI. For carousel posts, regenerates all slides or a specific slide via slot_index. From the 6th generation onwards, an extra credit is charged - confirm with confirm_extra_content: true.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id:                    { type: 'string', description: 'Post UUID' },
+        confirm_extra_content: { type: 'boolean', description: 'Set true to confirm extra credit charge (6th+ generation)' },
+        slot_index:            { type: 'integer', minimum: 0, maximum: 5, description: 'Carousel slide index to regenerate (omit to regenerate all slides)' },
+      },
+    },
+  },
+
+  {
+    name: 'uploadPostVideo',
+    description: 'Uploads a video (mp4, mov or webm; up to 120 MB) as the post media, replacing the current image/video. Provide either file_path (local file) or video_url (public URL to download from). When the post is published to Instagram, videos are posted as Reels (also shared to the feed). Scheduling works the same as image posts.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id:        { type: 'string', description: 'Post UUID' },
+        file_path: { type: 'string', description: 'Absolute path to a local video file (mp4, mov, webm)' },
+        video_url: { type: 'string', description: 'Public URL of the video to download and upload' },
+      },
+    },
+  },
+
+  // ─── API KEYS ─────────────────────────────────────────────────────────────
+
+  {
+    name: 'listApiKeys',
+    description: "Lists the user's active (non-revoked) API keys. The full key is never returned after creation.",
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+
+  {
+    name: 'createApiKey',
+    description: 'Creates a new API key. The full key (atray_...) is returned ONLY in this response - save it immediately. Limit: 10 keys per user.',
+    inputSchema: {
+      type: 'object',
+      required: ['name'],
+      properties: {
+        name: { type: 'string', maxLength: 100, description: 'Descriptive name for the key' },
+      },
+    },
+  },
+
+  {
+    name: 'updateApiKey',
+    description: 'Updates the name and/or active status of an API key. Inactive keys are rejected at authentication.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id:        { type: 'string', description: 'API key UUID' },
+        name:      { type: 'string', maxLength: 100, description: 'New name for the key' },
+        is_active: { type: 'boolean', description: 'Activate or deactivate the key' },
+      },
+    },
+  },
+
+  {
+    name: 'revokeApiKey',
+    description: 'Permanently revokes an API key. This action cannot be undone.',
+    inputSchema: {
+      type: 'object',
+      required: ['id'],
+      properties: {
+        id: { type: 'string', description: 'API key UUID' },
+      },
+    },
+  },
+];