Spline MCP Server

Implementation Reference

• src/tools/api-webhook-tools.js:185-212 (handler)

  Primary MCP tool implementation for 'getWebhooks'. Registers the tool with input schema for sceneId, executes logic to fetch webhooks via apiClient and return JSON-formatted list or error response.

  server.tool(
    'getWebhooks',
    {
      sceneId: z.string().min(1).describe('Scene ID'),
    },
    async ({ sceneId }) => {
      try {
        const webhooks = await apiClient.getWebhooks(sceneId);
        return {
          content: [
            { 
              type: 'text', 
              text: JSON.stringify(webhooks, null, 2) 
            }
          ]
        };
      } catch (error) {
        return {
          content: [
            { 
              type: 'text', 
              text: `Error retrieving webhooks: ${error.message}` 
            }
          ],
          isError: true
        };
      }
    }

• src/utils/api-client.js:212-214 (helper)

  API client helper method that performs the HTTP GET request to Spline API to retrieve webhooks for the given sceneId.

  async getWebhooks(sceneId) {
    return this.request('GET', `/scenes/${sceneId}/webhooks`);
  }

• src/index.js:91-91 (registration)

  Registers the api-webhook-tools module (containing getWebhooks tool) with the main MCP server instance.

  registerApiWebhookTools(server);

• src/tools/api-webhook-tools.js:187-189 (schema)

  Zod input schema for the getWebhooks tool: requires a non-empty sceneId string.

  {
    sceneId: z.string().min(1).describe('Scene ID'),
  },