Rivian MCP

Instructions

Implementation Reference

• mcp-server.js:521-535 (registration)

  Tool registration with MCP server, including the schema definition (vehicle_id parameter) and handler that calls rivian.getDriversAndKeys() and formats the output.

  server.tool(
    'rivian_get_drivers_and_keys',
    'See who has access to your vehicle — drivers, phone keys, and key fobs.',
    {
      vehicle_id: z.string().describe('Vehicle ID from your account info'),
    },
    async ({ vehicle_id }) => {
      try {
        requireAuth();
        return text(formatDriversAndKeys(await rivian.getDriversAndKeys(vehicle_id)));
      } catch (err) {
        return text(err.message);
      }
    },
  );

• mcp-server.js:527-534 (handler)

  The async handler function that executes when the tool is called - requires authentication, calls the API, and returns formatted text.

  async ({ vehicle_id }) => {
    try {
      requireAuth();
      return text(formatDriversAndKeys(await rivian.getDriversAndKeys(vehicle_id)));
    } catch (err) {
      return text(err.message);
    }
  },

• mcp-server.js:525-525 (schema)

  Zod schema defining the vehicle_id input parameter for the tool.

  vehicle_id: z.string().describe('Vehicle ID from your account info'),

• lib/rivian.js:224-248 (handler)

  Core implementation that executes the GraphQL query to Rivian's API to fetch drivers, phone keys, and key fobs for a given vehicle.

  export async function getDriversAndKeys(vehicleId) {
    const body = {
      operationName: 'DriversAndKeys',
      query: `query DriversAndKeys($vehicleId: String) {
    getVehicle(id: $vehicleId) {
      __typename
      id
      vin
      invitedUsers {
        __typename
        ... on ProvisionedUser {
          firstName lastName email roles userId
          devices { type mappedIdentityId id hrid deviceName isPaired isEnabled }
        }
        ... on UnprovisionedUser {
          email inviteId status
        }
      }
    }
  }`,
      variables: { vehicleId },
    };
  
    return (await gql(GRAPHQL_GATEWAY, body, authHeaders())).getVehicle;
  }

• mcp-server.js:347-380 (helper)

  Helper function that formats the API response into readable text, displaying user roles, devices, and their pairing/enabled status.

  function formatDriversAndKeys(data) {
    const lines = [];
  
    if (data.vin) lines.push(`Vehicle: ${data.vin}`);
  
    if (!data.invitedUsers?.length) {
      lines.push('No drivers or keys found.');
      return lines.join('\n');
    }
  
    lines.push('');
    for (const user of data.invitedUsers) {
      if (user.firstName) {
        lines.push(`${user.firstName} ${user.lastName} (${user.email})`);
        if (user.roles?.length) lines.push(`  Roles: ${user.roles.join(', ')}`);
  
        if (user.devices?.length) {
          for (const d of user.devices) {
            const name = d.deviceName || d.type;
            const status = [
              d.isPaired ? 'paired' : 'not paired',
              d.isEnabled ? 'enabled' : 'disabled',
            ].join(', ');
            lines.push(`  ${name} — ${status}`);
          }
        }
      } else {
        lines.push(`${user.email} (invited, ${user.status})`);
      }
      lines.push('');
    }
  
    return lines.join('\n').trim();
  }