PI API MCP Server

Instructions

Implementation Reference

• build/index.js:459-535 (handler)

  Full implementation of the 'authenticate-with-credentials' tool, including inline handler that authenticates via basic auth to the /tokens endpoint using provided username and password, sets the global authToken on success.

  server.tool("authenticate-with-credentials", "Authenticate with the PI API using username and password (last resort option)", {
      credentials: z.string().describe("Username and password as 'username password'")
  }, async ({ credentials }) => {
      try {
          if (!apiUrlSet) {
              return {
                  isError: true,
                  content: [{
                          type: "text",
                          text: "API URL not set. Please set the API URL first using the set-api-url tool."
                      }]
              };
          }
          // Parse credentials - simple space separation
          const parts = credentials.trim().split(/\s+/);
          if (parts.length < 2) {
              return {
                  isError: true,
                  content: [{
                          type: "text",
                          text: "Invalid credentials format. Please provide as 'username password'"
                      }]
              };
          }
          // First part is username, rest is considered password (in case password has spaces)
          const username = parts[0];
          const password = parts.slice(1).join(' ');
          if (!username || !password) {
              return {
                  isError: true,
                  content: [{
                          type: "text",
                          text: "Both username and password are required. Please provide as 'username password'"
                      }]
              };
          }
          // Authenticate with the credentials
          const credentialsBase64 = Buffer.from(`${username}:${password}`).toString("base64");
          const response = await fetch(`${API_BASE_URL}/tokens`, {
              method: "POST",
              headers: {
                  "Content-Type": "application/json",
                  "Authorization": `basic ${credentialsBase64}`
              }
          });
          if (!response.ok) {
              const errorText = await response.text();
              return {
                  isError: true,
                  content: [{ type: "text", text: `Authentication failed: ${response.status} - ${errorText}` }]
              };
          }
          const data = await response.json();
          if (data && typeof data === 'object' && 'token' in data && typeof data.token === 'string') {
              authToken = data.token;
              connectionVerified = true;
          }
          else {
              return {
                  isError: true,
                  content: [{ type: "text", text: "Authentication failed: Invalid response format" }]
              };
          }
          return {
              content: [{
                      type: "text",
                      text: "✅ Authentication successful. You can now use other tools and resources."
                  }]
          };
      }
      catch (error) {
          return {
              isError: true,
              content: [{ type: "text", text: `Error authenticating: ${getErrorMessage(error)}` }]
          };
      }
  });

• build/index.js:460-460 (schema)

  Input schema for the tool using Zod: expects a single string parameter 'credentials' formatted as 'username password'.

  credentials: z.string().describe("Username and password as 'username password'")

• build/index.js:459-459 (registration)

  Registration of the tool on the MCP server with name, description, schema, and inline handler.

  server.tool("authenticate-with-credentials", "Authenticate with the PI API using username and password (last resort option)", {