Pollinations Multimodal MCP Server

Instructions

Implementation Reference

• src/services/authService.js:135-170 (handler)

  The main handler function for the getDomains tool. Fetches the user's allowlisted domains from the Pollinations auth API using the provided GitHub userId and JWT accessToken. Returns MCP-formatted response with the domains data.

  async function getDomains(params) {
      const { userId, accessToken } = params;
  
      if (!userId || typeof userId !== "string") {
          throw new Error("User ID is required and must be a string");
      }
  
      if (!accessToken || typeof accessToken !== "string") {
          throw new Error("Access token is required and must be a string");
      }
  
      try {
          // Call the auth.pollinations.ai domains endpoint with JWT
          const response = await fetch(
              `${AUTH_API_BASE_URL}/api/user/${userId}/domains`,
              {
                  headers: {
                      Authorization: `Bearer ${accessToken}`,
                  },
              },
          );
  
          if (!response.ok) {
              throw new Error(`Failed to get domains: ${response.statusText}`);
          }
  
          // Get the domains data
          const domainsData = await response.json();
  
          // Return the response in MCP format
          return createMCPResponse([createTextContent(domainsData, true)]);
      } catch (error) {
          console.error("Error getting domains:", error);
          throw error;
      }
  }

• src/services/authService.js:331-336 (schema)

  Zod input schema defining the required parameters: userId (string) and accessToken (string) for the getDomains tool.

  {
      userId: z.string().describe("The GitHub user ID"),
      accessToken: z
          .string()
          .describe("The JWT access token from exchangeToken"),
  },

• src/services/authService.js:327-338 (registration)

  Registration entry for the getDomains tool in the exported authTools array, including tool name, description (with Gen-Z instructions), input schema, and reference to the handler function.

  [
      "getDomains",
      "Get domains allowlisted for a user using JWT authentication." +
          genZInstructions,
      {
          userId: z.string().describe("The GitHub user ID"),
          accessToken: z
              .string()
              .describe("The JWT access token from exchangeToken"),
      },
      getDomains,
  ],