Sociona MCP Server

Instructions

Implementation Reference

• src/index.ts:318-333 (handler)

  The core handler function that executes the tool by making a DELETE API request to cancel the scheduled post using the provided postId and returns a success message or throws an error.

  private async cancelScheduledPost(args: any) {
    const result = await this.apiRequest('DELETE', `/schedule/${args.postId}`);
  
    if (result.success) {
      return {
        content: [
          {
            type: 'text',
            text: `✅ Scheduled post ${args.postId} has been canceled.`,
          },
        ],
      };
    } else {
      throw new Error(result.message || 'Failed to cancel scheduled post');
    }
  }

• src/index.ts:107-120 (registration)

  Registers the 'cancel_scheduled_post' tool in the ListTools response, including its name, description, and input schema requiring a 'postId'.

  {
    name: 'cancel_scheduled_post',
    description: 'Cancel a scheduled post before it publishes',
    inputSchema: {
      type: 'object',
      properties: {
        postId: {
          type: 'string',
          description: 'The ID of the scheduled post to cancel',
        },
      },
      required: ['postId'],
    },
  },

• src/index.ts:148-149 (registration)

  Dispatches tool calls to the cancelScheduledPost handler in the CallToolRequestSchema handler switch statement.

  case 'cancel_scheduled_post':
    return await this.cancelScheduledPost(args);

• src/index.ts:110-119 (schema)

  Defines the input schema for the tool, specifying 'postId' as a required string.

  inputSchema: {
    type: 'object',
    properties: {
      postId: {
        type: 'string',
        description: 'The ID of the scheduled post to cancel',
      },
    },
    required: ['postId'],
  },

• src/index.ts:170-195 (helper)

  Shared helper method used by the handler to make authenticated API requests to the Sociona backend.

  private async apiRequest(method: string, endpoint: string, body?: any) {
    const url = `${API_BASE}${endpoint}`;
    console.error(`Making ${method} request to ${url}`);
  
    const response = await fetch(url, {
      method,
      headers: {
        'Authorization': `Bearer ${SOCIONA_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: body ? JSON.stringify(body) : undefined,
    });
  
    if (!response.ok) {
      let errorMessage = `API request failed with status ${response.status}`;
      try {
        const errorData = await response.json();
        errorMessage = errorData.message || errorMessage;
      } catch (e) {
        // Ignore JSON parse errors
      }
      throw new Error(errorMessage);
    }
  
    return response.json();
  }