Insforge MCP Server

Instructions

Implementation Reference

• src/shared/tools.ts:820-871 (handler)

  Core handler that reads JavaScript code from a specified file and sends a POST request to the API endpoint to create a new edge function. Handles file reading errors and API responses, formats success/error messages.

  withUsageTracking('create-function', async (args) => {
    try {
      let code: string;
      try {
        code = await fs.readFile(args.codeFile, 'utf-8');
      } catch (fileError) {
        throw new Error(
          `Failed to read code file '${args.codeFile}': ${fileError instanceof Error ? fileError.message : 'Unknown error'}`
        );
      }
  
      const response = await fetch(`${API_BASE_URL}/api/functions`, {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'x-api-key': getApiKey(),
        },
        body: JSON.stringify({
          slug: args.slug,
          name: args.name,
          code: code,
          description: args.description,
          status: args.status,
        }),
      });
  
      const result = await handleApiResponse(response);
  
      return await addBackgroundContext({
        content: [
          {
            type: 'text',
            text: formatSuccessMessage(
              `Edge function '${args.slug}' created successfully from ${args.codeFile}`,
              result
            ),
          },
        ],
      });
    } catch (error) {
      const errMsg = error instanceof Error ? error.message : 'Unknown error occurred';
      return {
        content: [
          {
            type: 'text',
            text: `Error creating function: ${errMsg}`,
          },
        ],
        isError: true,
      };
    }
  })

• src/shared/tools.ts:812-819 (schema)

  Input schema definition for the create-function tool. Uses functionUploadRequestSchema (omitting code field) and adds required codeFile parameter pointing to the JS source file.

  {
    ...functionUploadRequestSchema.omit({ code: true }).shape,
    codeFile: z
      .string()
      .describe(
        'Path to JavaScript file containing the function code. Must export: module.exports = async function(request) { return new Response(...) }'
      ),
  },

• src/shared/tools.ts:809-872 (registration)

  Full registration of the 'create-function' tool on the MCP server, including name, description, input schema, and handler function wrapped with usage tracking.

  server.tool(
    'create-function',
    'Create a new edge function that runs in Deno runtime. The code must be written to a file first for version control',
    {
      ...functionUploadRequestSchema.omit({ code: true }).shape,
      codeFile: z
        .string()
        .describe(
          'Path to JavaScript file containing the function code. Must export: module.exports = async function(request) { return new Response(...) }'
        ),
    },
    withUsageTracking('create-function', async (args) => {
      try {
        let code: string;
        try {
          code = await fs.readFile(args.codeFile, 'utf-8');
        } catch (fileError) {
          throw new Error(
            `Failed to read code file '${args.codeFile}': ${fileError instanceof Error ? fileError.message : 'Unknown error'}`
          );
        }
  
        const response = await fetch(`${API_BASE_URL}/api/functions`, {
          method: 'POST',
          headers: {
            'Content-Type': 'application/json',
            'x-api-key': getApiKey(),
          },
          body: JSON.stringify({
            slug: args.slug,
            name: args.name,
            code: code,
            description: args.description,
            status: args.status,
          }),
        });
  
        const result = await handleApiResponse(response);
  
        return await addBackgroundContext({
          content: [
            {
              type: 'text',
              text: formatSuccessMessage(
                `Edge function '${args.slug}' created successfully from ${args.codeFile}`,
                result
              ),
            },
          ],
        });
      } catch (error) {
        const errMsg = error instanceof Error ? error.message : 'Unknown error occurred';
        return {
          content: [
            {
              type: 'text',
              text: `Error creating function: ${errMsg}`,
            },
          ],
          isError: true,
        };
      }
    })
  );

• src/http/server.ts:129-132 (registration)

  Calls registerInsforgeTools to register all tools (including create-function) on the HTTP MCP server.

  registerInsforgeTools(mcpServer, {
    apiKey,
    apiBaseUrl,
  });

• src/stdio/index.ts:20-23 (registration)

  Calls registerInsforgeTools to register all tools (including create-function) on the stdio MCP server.

  const toolsConfig = registerInsforgeTools(server, {
    apiKey: api_key,
    apiBaseUrl: api_base_url || process.env.API_BASE_URL,
  });