DNDzgz MCP Server

Instructions

Implementation Reference

• index.js:164-183 (handler)

  The handler function that implements the tool logic: fetches bike and free slot estimations from the Bizi API for a given station ID and returns the JSON data or an error message.

  async ({ station }) => {
    const response = await fetch(
      `https://dndzgz.herokuapp.com/services/bizi/${station}`
    );
    if (response.ok) {
      const data = await response.json();
      return {
        content: [{ type: "text", text: JSON.stringify(data) }],
      };
    } else {
      return {
        content: [
          {
            type: "text",
            text: `Is not possible to get the estimate for the Bizi station ${station}`,
          },
        ],
      };
    }
  }

• index.js:163-163 (schema)

  Zod schema for the tool input: requires a numeric 'station' parameter.

  { station: z.number() },

• index.js:160-184 (registration)

  Registration of the 'zaragoza-bizi-estimations' tool on the MCP server with name, description, schema, and handler.

  server.tool(
    "zaragoza-bizi-estimations",
    "Get the estimation of bikes and free slots in a Bizi station in Zaragoza in realtime",
    { station: z.number() },
    async ({ station }) => {
      const response = await fetch(
        `https://dndzgz.herokuapp.com/services/bizi/${station}`
      );
      if (response.ok) {
        const data = await response.json();
        return {
          content: [{ type: "text", text: JSON.stringify(data) }],
        };
      } else {
        return {
          content: [
            {
              type: "text",
              text: `Is not possible to get the estimate for the Bizi station ${station}`,
            },
          ],
        };
      }
    }
  );